Picgomcp

🚀 Image Upload MCP Service (Based on PicGo)

This is an MCP (Model Context Protocol) server that allows interaction with a running PicGo application to upload images.

📋 Overview

This server exposes PicGo's image upload functionality as an MCP tool. It connects to PicGo application's built - in server (usually running at http://127.0.0.1:36677) and provides a tool to upload local image files.

📋 Prerequisites

1. Node.js: Ensure Node.js is installed (recommended v18 or higher).
2. PicGo Application: A running PicGo desktop application is required.
3. PicGo Server Enabled: In PicGo's settings (PicGo Settings -> Settings Server), enable the server. The default port is 36677. Make sure it is running.
4. NPM or Yarn: Used to install packages.

📦 Installation

npm install -g picgo-uploader

Or

yarn global add picgo-uploader

This will globally install the MCP server and make the picgo-uploader command available.

🚀 Starting the Service

Execute the following command in the terminal:

picgo-uploader

The server will start and listen for MCP connections on stdio. You should see a message similar to the following:

PicGo Uploader MCP server is running on stdio

Keep this terminal window open as long as you need to use the server.

💻 Usage (MCP Tool)

Once the server is running and connected to your MCP client (such as Roo Code), you can use the provided tool:

Tool: upload_image_via_picgo

• Description: Upload one or more images using the running PicGo server application.
• Input Schema:

  {
    "type": "object",
    "properties": {
      "image_paths": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array containing the absolute paths of the image files to be uploaded."
      }
    },
    "required": ["image_paths"]
  }
  

• Output: On success, it returns a JSON string containing an array of uploaded image URLs provided by PicGo. On failure, it returns an error message.

Example (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>

⚠️ Important Note

Ensure that the paths provided in image_paths are absolute paths on the device where picgo-uploader is running.

🛠️ Possible Errors and Issues

1. PicGo Server Connection Refused:
   • Check if PicGo is running.
   • Confirm that the server option is enabled and the port is not occupied.
2. File Not Found Error:
   • Ensure that the provided paths are correct absolute paths.
3. Upload Issues:
   • Check PicGo's configuration, especially if the selected image hosting service is correctly configured.

🔨 Development

If you want to modify or extend this project, follow these steps:

1. Clone the repository:

   git clone [Repository URL]
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Run the development server:

   npm start
   

The main functions of this project include handling MCP protocol communication and interacting with the PicGo server. The code structure is relatively simple, mainly dealing with path resolution and network requests.

🌟 Summary

This tool allows for automated image uploads to various image hosting services, which is very convenient for developers. Make sure PicGo is configured correctly, and all paths and settings are properly configured to avoid common errors.