Img Src Io MCP server

img-src MCP Server

Model Context Protocol (MCP) server for img-src.io image hosting API.

This server enables AI assistants like Claude to interact with your img-src.io account - uploading, searching, listing, and managing images directly through natural language.

Installation

pnpm add -g @img-src/mcp-server

Or run directly with pnpm dlx:

pnpm dlx @img-src/mcp-server

Configuration

Environment Variables

Getting an API Key

1. Log in to img-src.io
2. Go to Settings > API Keys
3. Create a new API key
4. Copy the key (it starts with imgsrc_)

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claudedesktopconfig.json on macOS):

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Usage with Claude Code

Add to your project's .mcp.json (project-scoped) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Or add it via the CLI:

claude mcp add img-src -- npx @img-src/mcp-server

Then set the API key in your environment or .env file:

export IMG_SRC_API_KEY=imgsrc_your_api_key_here

Usage with Cursor

1. Open Cursor Settings (Cmd+, on macOS / Ctrl+, on Windows/Linux)
2. Navigate to Features > MCP Servers
3. Click "Add new MCP server"
4. Enter the following configuration:

• Name: img-src
• Type: command
• Command: npx @img-src/mcp-server

1. Add the environment variable IMGSRCAPI_KEY with your API key.

Alternatively, create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Usage with VS Code (GitHub Copilot)

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "img-src": {
      "type": "stdio",
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Or add via CLI:

code --add-mcp '{"name":"img-src","command":"npx","args":["@img-src/mcp-server"],"env":{"IMG_SRC_API_KEY":"imgsrc_your_api_key_here"}}'

Note: VS Code uses "servers" (not "mcpServers") and requires "type": "stdio".

Usage with Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Usage with Cline

Open the Cline extension in VS Code, click the MCP Servers icon > Configure MCP Servers, then add:

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Usage with Zed

Add to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

Note: Zed uses "context_servers" as the key, embedded within the main settings.json.

Usage with JetBrains IDEs

Shortened. The full README is on GitHub.