🚀 图片上传 MCP 服务（基于 PicGo）
这是一个 MCP（模型上下文协议）服务器，允许与运行中的 PicGo 应用程序交互以上传图片，为图片上传提供了便捷的解决方案。
🚀 快速开始
此服务器将 PicGo 的图片上传功能作为 MCP 工具公开。它连接到 PicGo 应用程序的内置服务器（通常在 http://127.0.0.1:36677 运行），并提供一个工具以上传本地图片文件。
✨ 主要特性
- 将 PicGo 的图片上传功能以 MCP 工具的形式公开，方便与其他应用交互。
- 支持上传一个或多个图片，使用运行中的 PicGo 服务器应用程序。
📦 安装指南
先决条件
- Node.js：确保安装了 Node.js（推荐 v18 或更高版本）。
- PicGo 应用程序：需要已安装并在运行的 PicGo 桌面应用程序。
- PicGo 服务器启用：在 PicGo 的设置中 (
PicGo 设置->设置Server)，启用服务器。默认端口为36677。请确保它正在运行。 - 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-uploaderserver_name>
<tool_name>upload_image_via_picgotool_name>
<arguments>
{
"image_paths": [
"C:\\Users\\YourUser\\Pictures\\screenshot1.png",
"/home/user/images/diagram.jpg"
]
}
arguments>
use_mcp_tool>
注意：确保 image_paths 中提供的路径是运行 picgo-uploader 的设备上的绝对路径。
📚 详细文档
可能的错误和问题
- PicGo 服务器连接被拒绝：
- 检查 PicGo 是否正在运行。
- 确认服务器选项已启用，并且端口未被占用。
- 文件不存在错误：
- 确保提供的路径是正确的绝对路径。
- 上传问题：
- 检查 PicGo 的配置，特别是选择的图床服务是否正确配置。
开发
如果您想修改或扩展此项目，请按照以下步骤操作：
- 克隆仓库：
git clone [仓库 URL]
- 安装依赖项：
npm install
- 构建项目：
npm run build
- 运行开发服务器：
npm start
此项目的主要功能包括处理 MCP 协议的通信和与 PicGo 服务器的交互。代码结构相对简单，主要处理路径解析和网络请求。
总结
这个工具允许自动化将图片上传到各种图床服务，对开发者非常方便。确保 PicGo 配置正确，并且所有路径和设置都已正确配置以避免常见错误。