使用说明

项目简介

Torobjo MCP Server 是一个基于 FastMCP 实现的 MCP 服务器，旨在为大型语言模型（LLM）应用提供商品搜索和 Instagram 内容分析功能。它集成了 Torob 电商平台的产品搜索能力和 Instagram 帖子信息抓取功能，以工具的形式通过 MCP 协议对外提供服务。

主要功能点

波斯语商品搜索：集成 Torob.com API，支持波斯语商品搜索，并返回商品标题、价格和链接。
Instagram 内容提取：能够从 Instagram 帖子 URL 中提取帖子描述文本（caption）。
生产级可靠性：具备自动重试、错误处理和速率限制等机制，保证服务的稳定性。
高性能：基于 FastMCP 构建，提供高效的模型通信和数据处理能力。
模块化设计：工具以独立端点形式暴露，方便扩展和维护。

安装步骤

安装 Python: 确保您的系统中已安装 Python 3.7 或更高版本。

克隆仓库: 使用 Git 克隆 TorobjoMCP 仓库到本地：

git clone https://github.com/TahaBakhtari/TorobjoMCP
cd TorobjoMCP

安装依赖: 使用 pip 安装项目所需的 Python 库：

pip install fastmcp python-dotenv requests selenium webdriver-manager

服务器配置

MCP 客户端需要配置连接到 Torobjo MCP 服务器的信息。以下是一个 JSON 格式的配置示例，您需要将其提供给您的 MCP 客户端。

{
  "serverName": "TorobjoMCP",
  "command": "python",
  "args": ["torob_mcp_server.py"],
  "transport": "stdio",
  "description": "Torobjo MCP Server 提供商品搜索和 Instagram 内容提取工具。"
}

配置项说明:

'serverName': 服务器的名称，可以自定义，例如 "TorobjoMCP"。
'command': 启动服务器的命令，这里使用 'python' 解释器。
'args': 启动命令的参数，指定要运行的 Python 脚本为 'torob_mcp_server.py'。
'transport': 指定 MCP 服务器使用的传输协议，这里使用 'stdio' (标准输入输出)。
'description': 对服务器的简要描述，方便客户端用户理解其功能。

注意: 请确保 'torob_mcp_server.py' 文件位于 MCP 客户端能够访问到的路径中，或者在 'args' 中指定正确的脚本路径。

基本使用方法

启动服务器: 在仓库目录下，根据上述配置，MCP 客户端将通过运行 'python torob_mcp_server.py' 命令来启动 Torobjo MCP 服务器。服务器启动后，将监听来自客户端的 MCP 请求。
客户端调用工具: 使用 MCP 客户端，您可以调用以下工具：
- 'search_torob': 用于搜索 Torob 平台上的商品。客户端需要提供商品查询关键词作为参数。
- 'get_instagram_caption': 用于提取 Instagram 帖子的描述文本。客户端需要提供 Instagram 帖子 URL 作为参数。
客户端通过 MCP 协议向服务器发送 JSON-RPC 请求来调用这些工具，服务器将执行相应的操作并将结果以 JSON-RPC 响应的形式返回给客户端。

关键词