mercari-jp-mcp

3.3

If you are the rightful owner of mercari-jp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Model Context Protocol (MCP) server setup for integrating with Mercari and Claude for Desktop.

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!

Related MCP Servers

View all developer_tools servers →

context7

4.9

by upstash

Context7 MCP provides up-to-date, version-specific documentation and code examples directly into your prompt, enhancing the capabilities of LLMs by ensuring they use the latest information.

developer_tools

claude-task-master

4.8

by eyaltoledano

Task Master is a task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.

ai_chatbot

git-mcp

4.6

by idosal

GitMCP is a free, open-source, remote Model Context Protocol (MCP) server that transforms GitHub projects into documentation hubs, enabling AI tools to access up-to-date documentation and code.

developer_tools

deepwiki-mcp

4.6

by regenrek

This is an unofficial Deepwiki MCP Server that processes Deepwiki URLs, crawls pages, converts them to Markdown, and returns documents or lists by page.

browser_automation

code2prompt

4.5

by mufeedvh

Code2Prompt is a tool that converts your codebase into a single LLM prompt, facilitating code analysis and generation.

developer_tools

repomix

4.5

by yamadashy

Repomix is a tool that packs your codebase into AI-friendly formats, making it easier to use with AI tools like LLMs.

developer_tools

mindsdb

4.5

by mindsdb

MindsDB is an open-source server that enables seamless interaction with large-scale federated data using the Model Context Protocol (MCP).

databases

mcp-server-calculator

4.4

by githejie

A Model Context Protocol server for calculating. This server enables LLMs to use calculator for precise numerical calculations.

developer_tools

mcp-reddit

4.4

by adhikasp

A Model Context Protocol (MCP) server that provides tools for fetching and analyzing Reddit content.

entertainment_and_media

DesktopCommanderMCP

4.4

by wonderwhy-er

Desktop Commander MCP is a tool that allows users to search, update, manage files, and run terminal commands using AI, without incurring API token costs.

file_systems

Sequential Thinking

4.3

by modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

research_and_data

Everything MCP Server

4.3

by modelcontextprotocol

The Everything MCP Server is a comprehensive test server designed to demonstrate the full capabilities of the Model Context Protocol (MCP). It is not intended for production use but serves as a valuable tool for developers building MCP clients.

developer_tools

graphlit-mcp-server

4.3

by graphlit

The Model Context Protocol (MCP) Server for the Graphlit Platform facilitates integration between MCP clients and the Graphlit service, enabling seamless ingestion, search, and retrieval of knowledge across various platforms.

knowledge_and_memory

Office-PowerPoint-MCP-Server

4.3

by GongRzhe

A MCP server for PowerPoint manipulation using python-pptx, providing tools for creating, editing, and manipulating PowerPoint presentations.

file_systems

whois-mcp

4.3

by bharathvaj-ganesan

The Whois MCP server allows AI agents to perform WHOIS lookups to retrieve domain details.

research_and_data

dev-mcp

4.3

by Shopify

This project implements a Model Context Protocol (MCP) server that interacts with Shopify Dev, supporting various tools to interact with different Shopify APIs.

developer_tools

evm-mcp-server

4.2

by mcpdotdirect

A comprehensive Model Context Protocol (MCP) server that provides blockchain services across multiple EVM-compatible networks.

finance

mcp-reasoner

4.2

by Jacck

MCP Reasoner is a reasoning implementation for Claude Desktop that enhances complex problem-solving using Beam Search and Monte Carlo Tree Search (MCTS).

developer_tools

prisma

4.1

by prisma

Prisma is a next-generation ORM for Node.js and TypeScript, providing tools for data modeling, migrations, and querying databases.

databases

algorand-mcp

4.1

by GoPlausible

This is a Model Context Protocol (MCP) implementation for Algorand blockchain interactions, providing a server package for blockchain interactions and a client package for wallet management and transaction signing.

communication

mcp-datetime

4.0

by ZeparHyfar

A datetime formatting service implemented as an MCP server for the Claude Desktop Application.

developer_tools

lisply-mcp

3.8

by gornskew

The Model Context Protocol (MCP) Wrapper for Lisp or Lisp-like Backends is a software adapter that enables Large Language Models (LLMs) to interact with Lisp-based development and runtime environments using the lightweight Lisply protocol.

developer_tools

supabase-mcp

3.8

by supabase-community

Connect your Supabase projects to AI assistants using the Model Context Protocol (MCP) server.

databases

Sequential Thinking MCP Server

3.8

by modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

research_and_data

Nx MCP Server

3.8

by nrwl

A Model Context Protocol server implementation for Nx, providing LLMs with deep access to monorepo structures.

cloud_platforms

mcp-jenkins

3.8

by lanbaoshen

The Model Context Protocol (MCP) Jenkins is an open-source implementation that integrates Jenkins with AI language models, ensuring secure and contextual AI interactions.

developer_tools

mcp-atlassian

3.8

by sooperset

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.

cloud_platforms