PicGoMCP

🚀 图片上传 MCP 服务（基于 PicGo）

这是一个 MCP（模型上下文协议）服务器，允许与运行中的 PicGo 应用程序交互以上传图片，为图片上传提供了便捷的解决方案。

🚀 快速开始

此服务器将 PicGo 的图片上传功能作为 MCP 工具公开。它连接到 PicGo 应用程序的内置服务器（通常在 http://127.0.0.1:36677 运行），并提供一个工具以上传本地图片文件。

✨ 主要特性

• 将 PicGo 的图片上传功能以 MCP 工具的形式公开，方便与其他应用交互。
• 支持上传一个或多个图片，使用运行中的 PicGo 服务器应用程序。

📦 安装指南

先决条件

1. Node.js：确保安装了 Node.js（推荐 v18 或更高版本）。
2. PicGo 应用程序：需要已安装并在运行的 PicGo 桌面应用程序。
3. PicGo 服务器启用：在 PicGo 的设置中 (PicGo 设置 -> 设置Server)，启用服务器。默认端口为 36677。请确保它正在运行。
4. NPM 或 Yarn：用于安装包。

安装命令

npm install -g picgo-uploader

或

yarn global add picgo-uploader

这将全局安装 MCP 服务器，并使 picgo-uploader 命令可用。

💻 使用示例

启动服务

在终端中执行命令：

picgo-uploader

服务器将启动并监听 MCP 连接的 stdio。您应该会看到类似以下的消息：

PicGo Uploader MCP 服务器在 stdio 上运行

保持此终端窗口打开，只要需要使用服务器。

使用（MCP 工具）

一旦服务器运行并连接到您的 MCP 客户端（如 Roo Code），您可以使用提供的工具：

工具：upload_image_via_picgo

• 描述：上传一个或多个图片，使用运行中的 PicGo 服务器应用程序。
• 输入模式：

{
  "type": "object",
  "properties": {
    "image_paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "包含要上传的图片文件绝对路径的数组。"
    }
  },
  "required": ["image_paths"]
}

• 输出：成功时，返回 JSON 字符串，其中包含 PicGo 提供的上传图片 URL 数组。失败时，返回错误消息。

示例 (use_mcp_tool)：

<use_mcp_tool>
  <server_name>picgo-uploader</server_name>
  <tool_name>upload_image_via_picgo</tool_name>
  <arguments>
  {
    "image_paths": [
      "C:\\Users\\YourUser\\Pictures\\screenshot1.png",
      "/home/user/images/diagram.jpg"
    ]
  }
  </arguments>
</use_mcp_tool>

注意：确保 image_paths 中提供的路径是运行 picgo-uploader 的设备上的绝对路径。

📚 详细文档

可能的错误和问题

1. PicGo 服务器连接被拒绝：
   • 检查 PicGo 是否正在运行。
   • 确认服务器选项已启用，并且端口未被占用。
2. 文件不存在错误：
   • 确保提供的路径是正确的绝对路径。
3. 上传问题：
   • 检查 PicGo 的配置，特别是选择的图床服务是否正确配置。

开发

如果您想修改或扩展此项目，请按照以下步骤操作：

1. 克隆仓库：

git clone [仓库 URL]

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

4. 运行开发服务器：

npm start

此项目的主要功能包括处理 MCP 协议的通信和与 PicGo 服务器的交互。代码结构相对简单，主要处理路径解析和网络请求。

总结

这个工具允许自动化将图片上传到各种图床服务，对开发者非常方便。确保 PicGo 配置正确，并且所有路径和设置都已正确配置以避免常见错误。