项目简介

Didlogic API MCP服务器是一个实现了 Model Context Protocol (MCP) 的后端应用，它允许大型语言模型（LLM）通过标准化的接口与 Didlogic API 服务进行交互。该服务器充当 LLM 和 Didlogic API 之间的桥梁，将 Didlogic 的各项功能以工具 (Tools) 和 Prompt 模板 (Prompts) 的形式暴露给 LLM 客户端，使得 LLM 能够方便地调用 Didlogic 的服务，例如查询账户余额、管理 SIP 账户、购买电话号码、查询通话记录和交易记录等。

主要功能点

完整的 Didlogic API 访问能力：通过 MCP 工具 (Tools) 提供对 Didlogic API 的全面访问。
预定义的 Prompt 模板：为常见操作提供便捷的 Prompt 模板，简化 LLM 交互。
账户余额管理：查询 Didlogic 账户余额。
SIP 账户 (sipfriends) 管理：管理 SIP 账户，包括创建、查询、更新和删除 SIP 账户。
IP 限制管理：管理 SIP 账户的 IP 访问限制。
电话号码购买管理：查询可购买的电话号码，并进行购买和移除操作。
通话记录访问：查询详细的通话历史记录。
交易记录访问：查询账户交易历史记录。

安装步骤

使用 PIP 安装

或者，您可以使用 pip 安装 'didlogic_mcp'：

pip install didlogic_mcp

安装完成后，您可以像脚本一样运行它，需要设置 Didlogic API 密钥：

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

注意：请将 'YOUR_DIDLOGIC_KEY' 替换为您实际的 Didlogic API 密钥。您需要在运行服务器之前设置 'DIDLOGIC_API_KEY' 环境变量。

服务器配置

MCP 服务器是为 MCP 客户端（如 Claude.app）设计的。您需要在 MCP 客户端中配置服务器的启动命令和参数，以便客户端能够连接到服务器。

以下是针对 Claude.app 的配置示例，请添加到您的 Claude 设置中：

使用 uvx

"mcpServers": {
  "didlogic": {
    "command": "uvx",
    "args": ["didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

使用 pip 安装

"mcpServers": {
  "didlogic": {
    "command": "python",
    "args": ["-m", "didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

配置参数说明：

'"didlogic"': 服务器名称，您可以自定义。
'"command"': 启动服务器的命令。
- '"uvx"': 当使用 'uvx' 运行时。
- '"python"': 当使用 pip 安装并通过 'python -m' 运行模块时。
'"args"': 传递给命令的参数。
- '["didlogic_mcp"]': 当使用 'uvx' 运行时，直接运行 'didlogic_mcp'。
- '["-m", "didlogic_mcp"]': 当使用 pip 安装时，以模块方式运行 'didlogic_mcp'。
'"env"': 环境变量设置。
- '"DIDLOGIC_API_KEY"': 必需，您的 Didlogic API 密钥，用于服务器连接 Didlogic API。请替换 '"YOUR_DIDLOGIC_KEY"' 为您的实际密钥。

基本使用方法

安装和配置服务器：按照上述安装步骤安装 'didlogic_mcp'，并根据您的环境选择 uv 或 pip 安装方式。然后，根据您的 MCP 客户端（例如 Claude.app）的要求，配置服务器连接信息，主要是启动命令及其参数，并确保设置了 'DIDLOGIC_API_KEY' 环境变量。
启动服务器：在配置好 MCP 客户端后，当客户端尝试连接到名为 "didlogic" 的 MCP 服务器时，客户端会根据您提供的配置启动 'didlogic_mcp' 服务器。
通过 LLM 客户端与 Didlogic API 交互：您可以使用支持 MCP 协议的 LLM 客户端（如 Claude.app）通过自然语言指令来调用 Didlogic API 的功能。例如，您可以向 LLM 提问 "我的 Didlogic 账户余额是多少？" 或指示 "创建一个新的 SIP 账户"。LLM 客户端会解析您的指令，并调用 Didlogic API MCP 服务器提供的工具 (Tools) 和 Prompt 模板 (Prompts) 来执行相应的操作，并将结果返回给您。

注意: 您无需直接操作服务器代码，所有的交互都应通过配置好的 MCP 客户端进行。服务器在后台运行，响应客户端的请求，并将 Didlogic API 的功能以结构化的方式提供给 LLM 使用。

关键词