内容
# 迪逻辑MCP服务器
[](https://archestra.ai/mcp-catalog/userad__didlogic_mcp)
迪逻辑API的模型上下文协议(MCP)服务器实现。该服务器允许大型语言模型(LLMs)通过标准化的接口与迪逻辑服务交互。
## 功能特点
- 通过MCP工具完全访问迪逻辑API
- 常见操作的专用提示
- 余额管理工具
- SIP账户(sipfriends)管理
- IP限制管理
- 购买管理
- 通话历史访问
- 交易历史访问
## 安装
### 使用uv(推荐)
使用[`uv`](https://docs.astral.sh/uv/)时,不需要特定的安装。我们将使用[`uvx`](https://docs.astral.sh/uv/guides/tools/)直接运行*didlogic_mcp*。
### 使用PIP
或者,您可以通过pip安装`didlogic_mcp`:
```bash
pip install didlogic_mcp
```
安装后,您可以通过以下方式作为脚本运行:
```bash
DIDLOGIC_API_KEY=您的DIDLOGIC密钥 python -m didlogic_mcp
```
## 传输模式
服务器支持三种传输模式:
### 标准输入/输出模式(默认)
用于与Claude Desktop或类似工具进行本地集成。使用`DIDLOGIC_API_KEY`环境变量进行身份验证。
```bash
# 使用uvx(推荐)
DIDLOGIC_API_KEY=您的密钥 uvx didlogic_mcp
# 使用uv运行
DIDLOGIC_API_KEY=您的密钥 uv 运行 didlogic_mcp
# 作为Python模块
DIDLOGIC_API_KEY=您的密钥 python -m didlogic_mcp --transport stdio
```
### HTTP模式
用于远程访问和网页客户端。每个请求需要在`Authorization`头部提供Bearer令牌。
```bash
# 使用默认端口(8000)
python -m didlogic_mcp --transport http
# 通过环境变量自定义端口
PORT=9000 python -m didlogic_mcp --transport http
# 自定义主机和端口
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000
# 开启调试日志
python -m didlogic_mcp --transport http --log-level DEBUG
```
**环境变量:**
- `PORT` - 服务器端口(默认:8000)
- `DIDLOGIC_API_URL` - 迪逻辑API基准URL(默认:https://app.didlogic.com/api)
**注意:** 在HTTP模式下,客户端必须在`Authorization`头部提供其API密钥作为Bearer令牌。
### SSE模式(服务器发送事件)
用于与持久连接进行流式通信。适用于实时更新和流式场景。每个请求需要在`Authorization`头部提供Bearer令牌。
```bash
# 使用默认端口(8000)
python -m didlogic_mcp --transport sse
# 通过环境变量自定义端口
PORT=9000 python -m didlogic_mcp --transport sse
# 自定义主机和端口
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000
# 开启调试日志
python -m didlogic_mcp --transport sse --log-level DEBUG
```
**环境变量:**
- `PORT` - 服务器端口(默认:8000)
- `DIDLOGIC_API_URL` - 迪逻辑API基准URL(默认:https://app.didlogic.com/api)
**注意:** 在SSE模式下,客户端必须在`Authorization`头部为持久流连接提供其API密钥作为Bearer令牌。
## 配置
### 为Claude.app配置
添加到您的Claude设置:
#### 使用uvx
```json
"mcpServers": {
"didlogic": {
"command": "uvx",
"args": ["didlogic_mcp"],
"env": {
"DIDLOGIC_API_KEY": "您的DIDLOGIC密钥"
}
}
}
```
#### 使用pip安装
```json
"mcpServers": {
"didlogic": {
"command": "python",
"args": ["-m", "didlogic_mcp"],
"env": {
"DIDLOGIC_API_KEY": "您的DIDLOGIC密钥"
}
}
}
```
### 为Claude Code配置
对于Claude Code,您可以连接到正在运行的SSE服务器实例:
```bash
claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer 您的DIDLOGIC_API密钥"
```
**前提条件:**
1. 以SSE模式启动服务器:`python -m didlogic_mcp --transport sse`
2. 运行上述命令,将`您的DIDLOGIC_API密钥`替换为您的实际API密钥
3. 服务器必须在指定的URL上运行并可访问
**自定义配置:**
- 使用不同的端口:更改`http://localhost:8000/sse`以匹配您的服务器的PORT设置
- 连接到远程服务器:将`localhost`替换为服务器的主机名或IP地址
## 许可证
MIT