Mercari Jp Mcp

デモ

要件

• Python 3.11 以降
• pyproject.toml に記載されている依存関係（以下を含む）：
  • mcp
  • mercari
  • pydantic

事前準備

1. uv https://docs.astral.sh/uv/getting-started/installation/

2. Microsoft C++ Build Tools（Windows の場合） https://visualstudio.microsoft.com/visual-cpp-build-tools/

セットアップ

1. このリポジトリをクローンします：

   git clone https://github.com/msr2903/mercari-jp-mcp.git
   cd mercari-jp-mcp
   

2. 仮想環境を作成して有効化し、依存関係をインストールします：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   uv pip install -e .
   

使用方法

開発モード

以下を実行すると、MCP Inspector でサーバーをテストできます：

uv run server.py

以下を実行すると、クエリ、除外キーワード、最小価格、最大価格を手動で入力してテストすることもできます：

uv run check_server.py

これによりサーバーが起動し、利用可能なツールをテストできます。

Claude for Desktop との連携

このサーバーを Claude for Desktop と連携するには：

1. Claude for Desktop をローカルマシンにインストールします。

2. VS Code をローカルマシンにインストールします。次に、以下のコマンドを実行して claude_desktop_config.json ファイルを開きます：

   • MacOS：code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows：code $env:AppData\Claude\claude_desktop_config.json

3. 次の場所にある Claude for Desktop の設定ファイルを編集します：

   • macOS：

     {
       "mcpServers": {
         "mercari": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mercari-jp-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • Windows：

     {
       "mcpServers": {
         "mercari": {
           "command": "uv",
           "args": [
             "--directory",
             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\mercari-jp-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • 注：command フィールドには uv の完全なパスを指定する必要がある場合があります。MacOS/Linux では which uv、Windows では where uv を実行すると確認できます。

4. Claude for Desktop を再起動します。

謝辞

以下を含む（ただしこれらに限らない）素晴らしいオープンソースプロジェクトなしには、この成果を実現できませんでした：

• jlowin/fastmcp (https://github.com/jlowin/fastmcp)
• marvinody/mercari (https://github.com/marvinody/mercari/)

これらのプロジェクトをコミュニティに公開してくださった作者の皆様に感謝します！