- Python 3.11 or higher
- Dependencies as listed in
pyproject.toml, including:- mcp
- mercari
- pydantic
-
Microsoft C++ Build Tools (For Windows) https://visualstudio.microsoft.com/visual-cpp-build-tools/
-
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 .
You can test the server with MCP Inspector by running:
uv run server.pyYou can also test to input manually the query, exclude keywords, min and max price by running:
uv run check_server.pyThis will start the server and allow you to test the available tools.
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.jsonfile:- MacOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
code $env:AppData\Claude\claude_desktop_config.json
- MacOS:
-
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 uvon MacOS/Linux orwhere uvon Windows.
-
-
Restart Claude for Desktop
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!