mercari-jp-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Demo
Related MCP server: photo-marketplace-listing-assistant
Requirements
Python 3.11 or higher
Dependencies as listed in
pyproject.toml, including:mcp
mercari
pydantic
Pre-setup
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-mcpCreate 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.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.
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.jsonfile:MacOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
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 uvon MacOS/Linux orwhere uvon 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!
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Unofficial MCP server for Goofish (Xianyu) deals, item details, seller stock, and Zhima Credit.
MCP server for searching Airweave collections with natural language queries.
Public MCP server for discovering open jobs. Search, filter, and get application links.
Official remote MCP server for SUZURI.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables users to search for products on the Mercari marketplace using keywords, categories, and specific filters like price and condition. It provides comprehensive tools for retrieving item details and browsing search results via standard or SSE protocols.-
- FlicenseNot gradedqualityDmaintenanceThis MCP server analyzes product photos using AI to generate listing drafts, publishes to Mercari Shops via GraphQL API, and exports drafts for other marketplaces.-
- FlicenseNot gradedqualityBmaintenanceMCP server to search Rakuten Ichiba (Japan's largest e-commerce platform) for products, returning names, prices, URLs, shop info, reviews, and images via the official Rakuten API.-
- AlicenseAqualityDmaintenanceMCP server for finding and monitoring deals on Japanese shopping sites via Doorzo. It enables AI assistants to search across 9 marketplaces, set price alerts, and check for new matches.7MIT