Skip to main content
Glama
mercari-jp-mcp

mercari-jp-mcp

by moikdev

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

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

  2. Microsoft C++ Build Tools (For Windows) https://visualstudio.microsoft.com/visual-cpp-build-tools/

Setup

  1. Clone this repository:

    git clone https://github.com/msr2903/mercari-jp-mcp.git
    cd mercari-jp-mcp
  2. 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:

  1. Install Claude for Desktop to your local machine.

  2. 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

  3. 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.

  4. 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!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP 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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      7
      MIT