Didlogic MCP Server

Didlogic MCP 服务

Didlogic API 的模型上下文协议（MCP）服务实现。此服务允许大语言模型（LLM）通过标准化接口与 Didlogic 服务交互。

功能

• 通过 MCP 工具完整访问 Didlogic API
• 为常见操作提供专用提示词
• 余额管理工具
• SIP 账户（sipfriends）管理
• IP 限制管理
• 采购管理
• 通话历史记录访问
• 交易历史记录访问

安装

使用 uv（推荐）

使用 uv 时，无需进行特定安装。我们将使用 uvx 直接运行 didlogic_mcp。

使用 PIP

或者，你也可以通过 pip 安装 didlogic_mcp：

pip install didlogic_mcp

安装后，可将其作为脚本运行：

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

传输模式

此服务支持三种传输模式：

STDIO 模式（默认）

用于与 Claude Desktop 或类似工具进行本地集成。使用 DIDLOGIC_API_KEY 环境变量进行身份验证。

# Using uvx (recommended)
DIDLOGIC_API_KEY=your_key uvx didlogic_mcp

# Using uv run
DIDLOGIC_API_KEY=your_key uv run didlogic_mcp

# As Python module
DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio

HTTP 模式

用于远程访问和 Web 客户端。每个请求都需要在 Authorization 标头中提供 Bearer 令牌。

# Using default port (8000)
python -m didlogic_mcp --transport http

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport http

# Custom host and port
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport http --log-level DEBUG

环境变量：

• PORT - 服务端口（默认：8000）
• DIDLOGIC_API_URL - Didlogic API 基础 URL（默认：https://app.didlogic.com/api）

**注意：**在 HTTP 模式下，客户端必须在 Authorization 标头中将 API 密钥作为 Bearer 令牌提供。

SSE 模式（服务器发送事件）

用于通过持久连接进行流式通信，适合实时更新和流式场景。每个请求都需要在 Authorization 标头中提供 Bearer 令牌。

# Using default port (8000)
python -m didlogic_mcp --transport sse

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport sse

# Custom host and port
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport sse --log-level DEBUG

环境变量：

• PORT - 服务端口（默认：8000）
• DIDLOGIC_API_URL - Didlogic API 基础 URL（默认：https://app.didlogic.com/api）

**注意：**在 SSE 模式下，客户端必须在 Authorization 标头中将 API 密钥作为 Bearer 令牌提供，以建立持久流式连接。

配置

配置 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"
    }
  }
}

配置 Claude Code

对于 Claude Code，你可以连接到正在运行的 SSE 服务实例：

claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"

前提条件：

1. 以 SSE 模式启动服务：python -m didlogic_mcp --transport sse
2. 运行上述命令，并将 YOUR_DIDLOGIC_API_KEY 替换为你的实际 API 密钥
3. 服务必须正在运行，并且可通过指定的 URL 访问

自定义配置：

• 使用不同端口：将 http://localhost:8000/sse 更改为与你的服务 PORT 设置相符的地址
• 连接到远程服务：将 localhost 替换为服务的主机名或 IP 地址

许可证

MIT