mercari-jp-mcp

Demo

Requirements

Python 3.11 or higher
Dependencies as listed in pyproject.toml, including:
- mcp
- mercari
- pydantic

Pre-setup

uv https://docs.astral.sh/uv/getting-started/installation/
Microsoft C++ Build Tools (For Windows) https://visualstudio.microsoft.com/visual-cpp-build-tools/

Setup

Clone this repository:

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

Create and activate a virtual environment and install dependencies:

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

Usage

Development Mode

You can test the server with MCP Inspector by running:

uv run server.py

You can also test to input manually the query, exclude keywords, min and max price by running:

uv run check_server.py

This will start the server and allow you to test the available tools.

Integration with Claude for Desktop

To integrate this server with Claude for Desktop:

Install Claude for Desktop to your local machine.
Install VS Code to your local machine. Then run the following command to open the claude_desktop_config.json file:
- MacOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Windows: code $env:AppData\Claude\claude_desktop_config.json

Edit the Claude for Desktop config file, located at:

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"
      ]
    }
  }
}

Note: You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.

Restart Claude for Desktop

Thanks

This work would not have been possible without amazing open source projects, including (but not limited to):

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

Thank you to the authors of these projects for making them available to the community!

Usage

Development Mode

You can test the server with MCP Inspector by running:

uv run server.py

You can also test to input manually the query, exclude keywords, min and max price by running:

uv run check_server.py

This will start the server and allow you to test the available tools.

Integration with Claude for Desktop

To integrate this server with Claude for Desktop:

Install Claude for Desktop to your local machine.

Install VS Code to your local machine. Then run the following command to open the claude_desktop_config.json file:

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

Edit the Claude for Desktop config file, located at:

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"
      ]
    }
  }
}

Note: You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.

Restart Claude for Desktop

Thanks

This work would not have been possible without amazing open source projects, including (but not limited to):

Thank you to the authors of these projects for making them available to the community!

更新履歴

Demo

Requirements

Pre-setup

Setup

Usage

Development Mode

Integration with Claude for Desktop

Thanks

更新履歴

Demo

Requirements

Pre-setup

Setup

Usage

Development Mode

Integration with Claude for Desktop

Thanks