Mercari商品搜索工具

演示

需求

• Python 3.11或更高版本
• 依赖关系如所列 pyproject.toml，包括：
  • 主控程序
  • 市场
  • 媒染剂

预设置

1. 紫外线 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  # On Windows: .venv\Scripts\activate
   uv pip install -e .
   

用法

开发模式

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

uv run server.py

您还可以通过运行以下命令来测试手动输入查询、排除关键字、最低和最高价格：

uv run check_server.py

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

与Claude for Desktop集成

要将此服务器与Claude for Desktop集成，请执行以下操作：

1. 将Claude for Desktop安装到本地计算机。

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

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

3. 编辑Claude for Desktop配置文件，位于：

   • macOS：

     复制

     {
       "mcpServers": {
         "mercari": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mercari-jp-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • 窗户：

     复制

     {
       "mcpServers": {
         "mercari": {
           "command": "uv",
           "args": [
             "--directory",
             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\mercari-jp-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • 备注：您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

4. 重新启动桌面版的Claude

谢谢

如果没有令人惊叹的开源项目，这项工作是不可能的，包括（但不限于）：

• jlowin/fastmcp(https://github.com/jlowin/fastmcp)
• 马文帝/默卡里(https://github.com/marvinody/mercari/)

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