项目简介

该项目是一个基于 Model Context Protocol (MCP) 构建的服务器实现，专注于连接大型语言模型（LLM）客户端与日本Mercari电商平台的商品搜索功能。它允许LLM通过标准化的MCP接口调用Mercari搜索工具，获取最新的商品信息。

主要功能点

• Mercari商品搜索: 允许LLM客户端根据关键词、排除关键词、价格范围等条件搜索日本Mercari上的在售商品。
• 结果过滤: 在基础搜索结果上，进一步根据关键词精确匹配和排除不需要的商品（如已损坏、旧型号等）。
• 结构化输出: 将搜索结果格式化为LLM易于理解和处理的结构化数据（包含商品名称、价格、链接）。
• MCP工具注册: 将Mercari搜索功能封装为一个标准的MCP工具 ('search_mercari_jp')，供兼容MCP的LLM客户端调用。

安装步骤

1. 克隆仓库: 克隆本GitHub仓库到您的本地机器：

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

2. 创建并激活虚拟环境: 使用 'uv' 工具创建并激活一个Python虚拟环境（推荐）：

   uv venv
   source .venv/bin/activate  # Windows系统使用: .venv\Scripts\activate
   

3. 安装依赖: 在激活的虚拟环境中安装项目依赖：

   uv pip install -e .
   

服务器配置（为MCP客户端准备）

此MCP服务器是供MCP客户端（如支持MCP的LLM应用程序）连接使用的。您需要在您的MCP客户端中进行如下配置，以便客户端知道如何启动并连接到此服务器：

在客户端的MCP服务器配置中，您需要指定一个名称来标识此服务器，并提供启动服务器脚本的命令和参数。配置通常采用JSON格式，包含以下关键字段：

• 'server name': 为此服务器指定一个唯一的名称，例如 '"mercari"'。
• 'command': 指定启动服务器的可执行文件路径。根据您的安装方式，这通常是 'uv' 或 'uv' 可执行文件的完整路径（您可以使用 'which uv' 或 'where uv' 命令查找）。
• 'args': 一个字符串列表，包含传递给 'command' 的参数。对于此服务器，这些参数应为 '["--directory", "/path/to/mercari-jp-mcp/parent/folder", "run", "server.py"]'。请将 '/path/to/mercari-jp-mcp/parent/folder' 替换为您克隆仓库所在的父目录的绝对路径。

例如，如果您的仓库位于 '/Users/username/mcp-servers/mercari-jp-mcp'，则父目录绝对路径为 '/Users/username/mcp-servers'。

基本使用方法

1. 手动启动服务器 (开发/测试用): 在项目根目录（'mercari-jp-mcp'）下激活虚拟环境，然后运行：

   uv run server.py
   

   这将启动MCP服务器，等待客户端连接。
2. 通过MCP客户端使用: 配置好您的MCP客户端后，启动客户端。客户端将根据配置自动启动此Mercari MCP服务器并通过标准输入/输出与之通信。一旦连接建立，您的LLM就可以通过调用名为 'search_mercari_jp' 的工具来执行Mercari搜索操作了。具体如何触发工具调用取决于您的LLM客户端界面和能力。