PicGo Uploader MCP Server

PicGo Uploader MCP Server

site icon
2025.04.19 0
JavaScript图片上传自动化工具文件管理
PicGoMCP 是一个基于 MCP(Model Context Protocol)协议的服务器,用于与运行中的 PicGo 应用程序交互,实现图片上传功能。该服务将 PicGo 的图片上传能力暴露为 MCP 工具,方便开发者通过 MCP 客户端(如 Roo Code)调用。
View on GitHub

Overview

基本能力

产品定位

PicGoMCP 是一个连接 PicGo 应用程序的 MCP 服务器,提供图片上传功能,适用于需要批量或自动化上传图片的场景。

核心功能

  1. 图片上传:通过 MCP 工具 upload_image_via_picgo 上传本地图片到 PicGo 配置的目标存储(如 GitHub、七牛云等)。
  2. 多文件支持:支持一次性上传多个图片文件。
  3. 跨平台兼容:支持 Windows 和 Linux 系统的绝对路径。

适用场景

  1. 开发者工具集成:在开发工具中集成图片上传功能,例如 Markdown 编辑器自动上传图片。
  2. 自动化脚本:通过脚本批量上传图片到指定的图床。
  3. 内容管理系统:在 CMS 系统中实现图片的快速上传和管理。

工具列表

  • upload_image_via_picgo:上传一个或多个图片文件到 PicGo 配置的图床。输入为包含图片绝对路径的 JSON 对象,输出为上传后的图片 URL 数组。

常见问题解答

  1. PicGo 服务器连接失败:确保 PicGo 应用程序正在运行,并且服务器已启用(默认端口 36677)。
  2. 图片路径不存在:检查提供的图片路径是否为绝对路径,并且文件确实存在。
  3. PicGo 上传失败:检查 PicGo 的日志,确认图床配置是否正确或网络是否正常。

使用教程

使用依赖

  1. Node.js:需安装 Node.js(推荐 v18 或更高版本)。
  2. PicGo 应用程序:需安装并运行 PicGo 桌面应用。
  3. PicGo 服务器启用:在 PicGo 设置中启用服务器(默认端口 36677)。

安装教程

npm install -g picgo-uploader
# 或
yarn global add picgo-uploader

运行服务器

picgo-uploader

服务器将启动并通过 stdio 监听 MCP 连接。

调试方式

  1. 确保 picgo-uploader 进程正在运行。
  2. 使用 MCP 客户端调用 upload_image_via_picgo 工具,检查返回的 URL 或错误信息。
  3. 查看 PicGo 应用程序的日志以获取更多上传失败的详细信息。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。