PicGo Uploader MCP Server

PicGo Uploader MCP Server

実行中の PicGo アプリケーションと連携して、画像をアップロードできる MCP（Model Context Protocol）サーバーです。

概要

このサーバーは、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： パッケージのインストールに使用します。

インストール

npm install -g picgo-uploader

または

yarn global add picgo-uploader

これにより、MCP サーバーがグローバルにインストールされ、picgo-uploader コマンドを使用できるようになります。

サーバーの起動

ターミナルで次のコマンドを実行してください。

picgo-uploader

サーバーが起動し、stdio 経由で MCP 接続を待ち受けます。次のようなメッセージが表示されます。

PicGo Uploader MCP server running on stdio

サーバーを使用する間は、このターミナルウィンドウを開いたままにしてください。

使用方法（MCP ツール）

サーバーが起動し、MCP クライアント（Roo Code など）に接続されると、提供されているツールを使用できます。

ツール： upload_image_via_picgo

• 説明： 実行中の PicGo サーバーアプリケーションを使用して、1 つ以上の画像をアップロードします。
• 入力スキーマ：

  {
    "type": "object",
    "properties": {
      "image_paths": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "アップロードする画像ファイルの絶対パスの配列です。"
      }
    },
    "required": ["image_paths"]
  }
  

• 出力： 成功すると、PicGo が返したアップロード済み画像 URL の配列を含む JSON 文字列を返します。失敗すると、エラーメッセージを返します。

使用例（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 サーバーが実行されているマシンからアクセス可能な絶対パスであることを確認してください。

トラブルシューティング

• エラー：「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（別のターミナルで実行）