返回 MCP 目录
public公开dns本地运行

TMF620 Product Catalog Management

TMF620 MCP服务器是一个连接AI代理与远程TMF620产品目录管理API的中间件,提供目录、产品供应和产品规格的查询及创建功能。

article

README

🚀 TMF620 MCP 服务器

TMF620 MCP 服务器是一个模型上下文协议 (MCP) 服务器,它能让 AI 代理与远程 TMF620 产品目录管理 API 进行交互,为 AI 代理与 API 之间搭建了桥梁,提升交互效率。

✨ 主要特性

  • 实现 AI 代理与远程 TMF620 产品目录管理 API 的连接。
  • 支持对目录、产品包和产品规范进行列出、检索和创建操作。
  • 具备可配置性,能够连接到任何符合 TMF620 标准的 API。

📦 安装指南

  1. 安装所需的依赖项:
pip install -r requirements.txt
  1. 配置与远程 TMF620 服务器的连接: 编辑 config.py 文件并更新以下设置:
  • TMF620_API_URL:您远程 TMF620 服务器的基础 URL。
  • AUTH_CONFIG:您远程服务器的身份验证详细信息(如果需要)。
  • 其他所需的配置。

💻 使用示例

基础用法

启动 MCP 服务器:

python mcp_server.py

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

高级用法

与 Claude Desktop 集成

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

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

AI 代理使用工具示例

以下是 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

📚 详细文档

可用工具

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 分发。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端