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 配置正確，並且所有路徑和設置都已正確配置以避免常見錯誤。