Mercari Jp Mcp

Name: Mercari Jp Mcp
Author: msr2903

@msr2903

About Mercari Jp Mcp

This is a Model Context Protocol (MCP) server that provides real time data from Japan’s Mercari (jp.mercari.com). It allows you to retrieve information about product and prices (more to come) to be analyzed by LLM.

#mcp #mercari #mercari-jp #mcp-server #mercari-jp-mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mercari-jp-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mercari Jp Mcp?

Mercari Jp Mcp is an MCP (Model Context Protocol) server that provides tools for searching Mercari Japan listings. It is designed for users of MCP-compatible clients like Claude for Desktop who want to query the Mercari Japan marketplace.

How to use Mercari Jp Mcp?

Clone the repository, create a virtual environment with uv, and install dependencies using uv pip install -e .. For development, run uv run server.py to test with MCP Inspector or uv run check_server.py to manually input search parameters. To integrate with Claude for Desktop, add a mercari entry in the claude_desktop_config.json file pointing uv to the repository directory and server.py.

Key features of Mercari Jp Mcp

Search Mercari Japan with user-defined queries
Exclude specific keywords from results
Filter by minimum and maximum price
Test via MCP Inspector or interactive script
Compatible with Claude for Desktop

Use cases of Mercari Jp Mcp

Searching for specific items on Mercari Japan from an AI assistant
Monitoring price ranges for used goods
Excluding unwanted categories or terms from search results

FAQ from Mercari Jp Mcp

What are the system requirements?

Python 3.11 or higher is required. Dependencies include mcp, mercari, and pydantic. Windows users also need Microsoft C++ Build Tools.

How do I install Mercari Jp Mcp?

Clone the repository, create and activate a virtual environment with uv, then run uv pip install -e . to install the package.

How do I configure it with Claude for Desktop?

Edit claude_desktop_config.json (located at ~/Library/Application Support/Claude/ on macOS or %AppData%\Claude\ on Windows) and add an entry for the server with the uv command pointing to the repository directory and server.py. You may need to use the full path to the uv executable.