项目简介

本项目实现了一个Model Context Protocol (MCP) 服务器，作为AI智能体与TMF620产品目录管理API之间的桥梁。它允许AI智能体通过标准化的MCP协议，远程访问和操作TMF620 API，实现产品目录、产品报价和产品规格的查询与管理。

主要功能点

• 连接TMF620 API: 允许AI智能体与远程TMF620产品目录管理API进行交互。
• 目录管理: 支持列出和获取产品目录信息。
• 产品报价管理: 支持列出、获取和创建产品报价信息。
• 产品规格管理: 支持列出、获取和创建产品规格信息。
• 健康检查: 提供服务器和API连接的健康状态检查工具。

安装步骤

1. 安装依赖: 确保你的Python环境中已安装 'pip'，然后执行以下命令安装项目依赖：

   pip install -r requirements.txt
   

服务器配置

要将此MCP服务器与MCP客户端（例如 Claude Desktop）配合使用，你需要在客户端中配置服务器连接信息。以下是 Claude Desktop 的配置示例，你需要将 'path/to/mcp_server.py' 替换为 'mcp_server.py' 文件在你本地文件系统中的实际路径。

{
  "mcpServers": {
    "tmf620": {
      "command": "python",
      "args": ["path/to/mcp_server.py"]  // 替换为 mcp_server.py 的实际路径
    }
  }
}

配置说明:

• 'server name': 'tmf620' (服务器名称，可自定义)
• 'command': 'python' (启动服务器的命令，这里使用 python 解释器)
• 'args': '["path/to/mcp_server.py"]' (启动命令的参数，指向 'mcp_server.py' 脚本的路径)

请确保 'mcp_server.py' 脚本的路径正确，并且你的Python环境可以执行该脚本。服务器默认监听 'http://localhost:7001' 端口。

基本使用方法

配置完成后，AI智能体可以通过以下工具指令与TMF620 API进行交互：

目录管理

• 列出所有产品目录: '/tool tmf620.list_catalogs'
• 获取指定产品目录详情: '/tool tmf620.get_catalog catalog_id=目录ID' (将 '目录ID' 替换为实际的目录ID)

产品报价管理

• 列出产品报价 (可按目录ID过滤): '/tool tmf620.list_product_offerings catalog_id=目录ID' (可选参数 'catalog_id')
• 获取指定产品报价详情: '/tool tmf620.get_product_offering offering_id=报价ID' (将 '报价ID' 替换为实际的报价ID)
• 创建新的产品报价: '/tool tmf620.create_product_offering name="报价名称" description="报价描述" catalog_id=目录ID' (替换为实际的名称、描述和目录ID)

产品规格管理

• 列出所有产品规格: '/tool tmf620.list_product_specifications'
• 获取指定产品规格详情: '/tool tmf620.get_product_specification specification_id=规格ID' (将 '规格ID' 替换为实际的规格ID)
• 创建新的产品规格: '/tool tmf620.create_product_specification name="规格名称" description="规格描述"' (替换为实际的名称和描述)

系统工具

• 检查服务器健康状态: '/tool tmf620.health'

注意: 工具指令中的 'tmf620' 前缀是在 Claude Desktop 配置文件中 'mcpServers' 下定义的服务器名称。

请参考仓库 'README.md' 文件和代码注释获取更详细的信息和高级用法。