Picgomcp

🚀 画像アップロードMCPサービス（PicGoベース）

このサービスは、画像のアップロードを支援するMCP（モデルコンテキストプロトコル）サーバーです。PicGoと連携することで、画像のアップロードを容易に行うことができます。

🚀 クイックスタート

このサーバーは、PicGoの画像アップロード機能をMCPツールとして公開します。通常、http://127.0.0.1:36677 で動作するPicGoアプリケーションの組み込みサーバーに接続し、ローカルの画像ファイルをアップロードするためのツールを提供します。

✨ 主な機能

• PicGoの画像アップロード機能をMCPツールとして公開します。
• ローカルの画像ファイルをアップロードすることができます。

📦 インストール

前提条件

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サーバーアプリケーションを使用して、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 を実行しているデバイス上の絶対パスであることを確認してください。

📚 ドキュメント

可能なエラーと問題

1. PicGoサーバーへの接続が拒否された場合
   • PicGoが実行中であることを確認してください。
   • サーバーオプションが有効になっており、ポートが使用されていないことを確認してください。
2. ファイルが存在しないエラー
   • 指定したパスが正しい絶対パスであることを確認してください。
3. アップロード問題
   • PicGoの設定を確認し、特に選択した画像ホスティングサービスが正しく設定されていることを確認してください。

開発方法

このプロジェクトを変更または拡張する場合は、以下の手順に従ってください。

1. リポジトリをクローンします。

   git clone [リポジトリURL]
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. 開発サーバーを実行します。

   npm start
   

このプロジェクトの主な機能は、MCPプロトコルの通信処理とPicGoサーバーとのやり取りです。コード構造は比較的シンプルで、主にパスの解析とネットワークリクエストを処理します。

まとめ

このツールを使用することで、画像を自動的に様々な画像ホスティングサービスにアップロードすることができ、開発者にとって非常に便利です。PicGoが正しく設定され、すべてのパスと設定が正しく構成されていることを確認して、一般的なエラーを回避してください。