AI导哈

图像管理服务器

Model Context Protocol (MCP) 服务器，为 img-src.io 图像托管 API 提供服务，支持通过自然语言上传、搜索、列出和管理图像。

  • by img-src-io
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 img-src-io/mcp

使用说明

img src MCP服务器

模型上下文协议（MCP）服务器 img-src.io 图像托管API。

该服务器使像Claude这样的人工智能助手能够与您的img-src.io帐户进行交互，直接通过自然语言上传、搜索、列出和管理图像。

安装

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

或者直接使用pnpm-dlx运行：

pnpm dlx @img-src/mcp-server

配置

环境变量

变量 必填 描述
IMG_SRC_API_KEY 是 您的img-src.io API密钥（以 imgsrc_)
IMG_SRC_API_URL 没有 API基本URL（默认值： https://api.img-src.io)

获取API密钥

  1. 登录到 img-src.io
  2. 前往“设置”>“API密钥”
  3. 创建新的API密钥
  4. 复制密钥（以开头 imgsrc_)

使用Claude Desktop

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

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

使用Claude代码

添加到您的项目 .mcp.json （项目范围）或 ~/.claude/mcp.json （全球）：

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

或者通过CLI添加它：

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

然后在您的环境中设置API密钥或 .env 文件：

export IMG_SRC_API_KEY=imgsrc_your_api_key_here

使用游标

  1. 打开光标设置(Cmd+, 在macOS上/ Ctrl+, 在Windows/Linux上）

  2. 导航到 功能>MCP服务器

  3. 点击 “添加新的MCP服务器”

  4. 输入以下配置：

    • 名字: img-src
    • 类型: command
    • 命令: npx @img-src/mcp-server

  5. 添加环境变量 IMG_SRC_API_KEY 使用API密钥。

或者，创建或编辑 .cursor/mcp.json 在项目根目录中：

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

使用VS代码（GitHub Copilot）

创建 .vscode/mcp.json 在您的工作空间中：

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

或者通过CLI添加：

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

注： VS代码使用 "servers" （不是 "mcpServers")并要求 "type": "stdio".

与Windsurf一起使用

增添 ~/.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"
      }
    }
  }
}

与Cline一起使用

在VS Code中打开Cline扩展，单击 MCP服务器 图标> 配置MCP服务器，然后添加：

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

使用Zed

添加到Zed设置(~/.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"
      }
    }
  }
}

注： Zed使用 "context_servers" 作为密钥，嵌入主 settings.json.

使用JetBrains IDE

在IntelliJ IDEA、WebStorm、PyCharm或其他JetBrains IDE中：

  1. 首选 设置>工具>AI助手>模型上下文协议（MCP）
  2. 点击 + （添加）并粘贴：
{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key_here"
      }
    }
  }
}

可用工具

upload_image

将图像从本地文件、URL或base64数据上传到您的img-src.io帐户。

Upload ~/Photos/sunset.jpg to img-src as photos/vacation/sunset.jpg

参数：

  • file_path （可选）：要上传的本地文件路径（建议用于大文件）
  • url （可选）：要上传的图像的URL
  • data （可选）：Base64编码图像数据
  • mimeType （可选）：图像的MIME类型（使用时需要 data)
  • target_path （可选）：组织图像的目标路径

注：其中之一 file_path, url，或 data 必须提供。

list_images

列出您帐户中的图像，也可以选择在特定文件夹中列出。

List my img-src images in the photos/vacation folder

参数：

  • folder （可选）：要列出的文件夹路径
  • limit （可选）：要返回的最大项目数（默认值：50）
  • offset （可选）：分页时要跳过的项目

搜索图片

按文件名或路径搜索图像。

Search for img-src images containing "beach"

参数：

  • query （必填）：搜索查询
  • limit （可选）：最大结果（默认值：20）
  • offset （可选）：跳过结果

获取图像

获取特定图像的详细元数据。

Get details for my img-src image at photos/vacation/sunset.jpg

参数：

  • id （必需）：映像ID（UUID）或文件路径

删除图像

永久删除图像。

Delete my img-src image at photos/old/unused.jpg

参数：

  • id （必需）：要删除的图像ID（UUID）或文件路径

获取_使用

查看您当前的使用统计数据。

Show my img-src usage stats

获取设置

获取您的帐户设置和配置。

What are my img-src account settings?

get_cdn_url

使用可选的图像转换生成CDN URL。

Generate an img-src CDN URL for john/photos/beach.jpg resized to 800x600

参数：

  • username （必填）：图像所有者的用户名
  • filepath （必填）：图像路径
  • width （可选）：调整宽度
  • height （可选）：调整高度
  • fit （可选）：覆盖、包含、填充、缩小
  • quality （可选）：1-100（默认值：80）
  • format （可选）：webp、avif、jpeg、png、jxl

资源

MCP服务器将您的图像作为克劳德可以直接访问的资源公开：

  • URI格式: imgsrc://images/{imageId}
  • 内容：JSON元数据，包括维度、格式和CDN URL

Claude可以列出并阅读这些资源，以了解您拥有的图像及其属性。

提示

常见工作流的预构建提示：

上传和分享

上传图像并获取可共享的CDN URL。

  • 论据： imageUrl （必填）， width （可选）

检查使用情况

检查帐户使用情况和存储状态。

  • 无需任何论据

查找图像

按关键字搜索图像。

  • 论据： query （必填）

对话示例

上传并分享图片

用户：上传~/Photos/sunset.jpg到img-src，给我一个调整大小的URL

克劳德：我会上传那张图片，并为你生成一个CDN URL。

[使用upload_image工具]

图片上传成功！这是一个调整大小的CDN URL： https://img-src.io/i/yourname/sunset.webp?w=1200&q=85

搜索和组织

用户：查找我所有的海滩照片

克劳德：[使用search_images和查询“beach”]

找到5张海滩照片：

  1. 照片/度假/海滩-sunset.jpg
  2. photos/summer/beach-party.png ...

检查用法

用户：我使用了多少存储空间？

克劳德：[使用get_usage工具]

您的img-src.io使用情况：

  • 存储空间：245 MB/500 MB（49%）
  • 上传量：本月67/100
  • 带宽：1.2 GB/1 GB（120%-考虑升级！）

发展

# Install dependencies
pnpm install

# Build
pnpm build

# Run locally
IMG_SRC_API_KEY=imgsrc_xxx pnpm start

# Type check
pnpm type-check

# Run tests
pnpm test

许可证

麻省理工学院

相关 MCP