PicGo Uploader MCP 服务器

这是一个MCP（Model Context Protocol）服务器，允许与正在运行的 PicGo 应用程序交互以上传图片。

概述

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

前提条件

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

安装

bash
npm install -g picgo-uploader

或者

bash
yarn global add picgo-uploader

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

运行服务器

只需在终端中执行以下命令：

bash
picgo-uploader

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

PicGo Uploader MCP server running on stdio

在使用服务器期间，请保持此终端窗口打开。

使用方法 (MCP 工具)

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

工具: upload_image_via_picgo

• 描述: 使用正在运行的PicGo服务器应用程序上传一个或多个图片。

• 输入模式:
  json
  {
  "type": "object",
  "properties": {
  "image_paths": {
  "type": "array",
  "items": {
  "type": "string"
  },
  "description": "要上传的图片文件的绝对路径数组。"
  }
  },
  "required": ["image_paths"]
  }

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

示例 (use_mcp_tool):

xml
<use_mcp_tool>
<server_name>picgo-uploader</server_name>
<tool_name>upload_image_via_picgo</tool_name>

{
"image_paths": [
"C:\Users\YourUser\Pictures\screenshot1.png",
"/home/user/images/diagram.jpg"
]
}

</use_mcp_tool>

注意: 确保image_paths中提供的文件路径是从运行picgo-uploader服务器的机器上可访问的绝对路径。

故障排除

• 错误: "PicGo server request error: connect ECONNREFUSED 127.0.0.1:36677":
  • 确保PicGo应用程序正在运行。
  • 验证PicGo服务器在其设置中已启用并且正在默认端口36677上运行。
• 错误: "Image path does not exist: ":
  • 双重检查提供的图片路径是否正确且为绝对路径。
  • 确保文件存在于运行picgo-uploader的机器上的指定位置。
• 错误: "PicGo upload failed: ...":
  • 这表示由PicGo本身报告的错误（例如，所选上传器的配置无效、网络问题）。请查看PicGo应用程序日志以获取更多详细信息。

开发

1. 克隆仓库。
2. 安装依赖项: npm install
3. 构建代码: npm run build
4. 开发运行: node build/index.js
5. 监视更改: npm run watch（在单独的终端中）