梅尔卡里日服MCP

演示

<img src="/assets/demo.gif" width="600" height="600"/>

要求

• Python 3.11 或更高版本
• 依赖项如 pyproject.toml 中所列，包括：
  • mcp
  • mercari
  • pydantic

预安装

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

2. Microsoft C++ 构建工具（适用于 Windows） https://visualstudio.microsoft.com/visual-cpp-build-tools/

安装

1. 克隆此仓库：

   git clone https://github.com/msr2903/mercari-jp-mcp.git
   cd mercari-jp-mcp
   

2. 创建并激活虚拟环境，并安装依赖项：

   uv venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   uv pip install -e .
   

使用方法

开发模式

你可以通过运行以下命令来使用 MCP Inspector 测试服务器：

uv run server.py

你也可以通过运行以下命令手动测试查询、排除关键词、最小和最大价格：

uv run check_server.py

这将启动服务器并允许你测试可用工具。

与桌面版 Claude 的集成

要将此服务器与桌面版 Claude 集成：

1. 将桌面版 Claude 安装到你的本地机器。

2. 将 VS Code 安装到你的本地机器。然后运行以下命令以打开 claude_desktop_config.json 文件：

   • MacOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: code $env:AppData\Claude\claude_desktop_config.json

3. 编辑桌面版 Claude 的配置文件，位于：

   • 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"
           ]
         }
       }
     }
     

   • 注意：你可能需要在命令字段中填写完整的 uv 可执行文件路径。你可以在 MacOS/Linux 上运行 which uv 或在 Windows 上运行 where uv 来获取该路径。

4. 重启桌面版 Claude

致谢

如果没有这些令人惊叹的开源项目（但不限于）的支持，这项工作是不可能完成的：

• jlowin/fastmcp (https://github.com/jlowin/fastmcp)
• marvinody/mercari (https://github.com/marvinody/mercari/)

感谢这些项目的作者将其提供给社区！