TMF620 Product Catalog Management

🚀 TMF620 MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，它能让 AI 代理与远程 TMF620 产品目录管理 API 进行交互，为 AI 代理操作产品目录提供了便利。

🚀 快速开始

本 MCP 服务器允许 AI 代理和远程 TMF620 产品目录管理 API 交互。以下是使用前的准备步骤：

1. 安装所需的依赖项：

pip install -r requirements.txt

2. 配置与远程 TMF620 服务器的连接： 编辑 config.py 文件并更新以下设置：

• TMF620_API_URL: 您远程 TMF620 服务器的基础 URL
• AUTH_CONFIG: 您远程服务器的身份验证详细信息（如果需要）
• 其他所需的配置

3. 启动 MCP 服务器：

python mcp_server.py

默认情况下，服务器将在 http://localhost:7001 上可用。

✨ 主要特性

• 将 AI 代理连接到远程 TMF620 产品目录管理 API。
• 支持列出、检索和创建目录、产品包和产品规范。
• 可配置连接到任何符合 TMF620 标准的 API。

📦 安装指南

安装依赖

pip install -r requirements.txt

配置连接

编辑 config.py 文件并更新以下设置：

• TMF620_API_URL: 您远程 TMF620 服务器的基础 URL
• AUTH_CONFIG: 您远程服务器的身份验证详细信息（如果需要）
• 其他所需的配置

💻 使用示例

基础用法

以下是 AI 代理可能使用这些工具的方式示例：

要列出所有目录：
/tool tmf620.list_catalogs

要获取特定目录：
/tool tmf620.get_catalog catalog_id=123456

要创建新目录：
/tool tmf620.create_catalog name="新目录" description="新的产品目录"

要列出产品包：
/tool tmf620.list_product_offerings name="Premium" is_bundle=true

要获取特定产品包：
/tool tmf620.get_product_offering offering_id=789012

要创建新的产品包：
/tool tmf620.create_product_offering name="Premium Service" description="高质量服务" is_bundle=false is_sellable=true

高级用法

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用，请在您的 Claude Desktop 配置中添加以下内容：

{
  "mcpServers": {
    "tmf620": {
      "command": "python",
      "args": ["path/to/mcp_server.py"]
    }
  }
}

📚 详细文档

可用工具

MCP 服务器为 AI 代理提供以下工具：

目录管理

• list_catalogs: 列出所有可用的产品目录
• get_catalog: 按 ID 获取特定产品目录
• create_catalog: 创建新的产品目录

产品包管理

• list_product_offerings: 根据可选的目录 ID 过滤列出所有产品包
• get_product_offering: 按 ID 获取特定产品包
• create_product_offering: 创建新的产品包

产品规范管理

• list_product_specifications: 列出所有产品规范
• get_product_specification: 按 ID 获取特定产品规范
• create_product_specification: 创建新的产品规范

系统工具

• health: 检查服务器和 API 连接的健康状况

扩展

要为其他 TMF620 终点添加更多工具，请编辑 mcp_server.py 文件并按照现有模式添加新的工具定义。

📄 许可证

此项目根据 MIT License 分发。