内容
XC MCP 服务器
[](LICENSE)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io)
**TCXC MCP 服务器** 是一个开源的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 服务器，它连接助手 — 如 Claude、OpenAI、Cursor 以及任何兼容 MCP 的客户端 — 到 [TelecomsXChange (TCXC)](https://www.telecomsxchange.com) 的批发电信市场。它提供了 **55 种工具和 种引导工作流**，用于语音终止、短信服务、DID 电话号码、eSIM 数据包、HLR 查询和运营商账户管理，使电信运营商和开发者可以用纯英文运行批发电信业务。
## AI 助手可以做什么？
| 功能 | AI 助手可以执行的操作 |
|---|---|
| **语音终止** | 按前缀搜索运营商费率，运行 A/B 路由测试调用，分析 CDR 和通话质量（ASR/ACD） |
| **短信服务** | 比较全球短信终止费率，查看交付历史和流量摘要 |
| **DID 号码** | 搜索、购买和配置虚拟电话号码（支持语音、短信、传真） |
| **eSIM 交换** | 按国家浏览数据包，购买 eSIM，充值和跟踪订单 |
| **号码智能** | 实时 HLR 查询，号码可携带性和欺诈/声誉评分 |
| **财务** | 实时查看买家/卖家余额和支付历史 |
| **账户管理** | 配置 SIP/SMS 子账户，管理 IP 地址，阻止/解除账户阻止 |
| **分析** | 实时通话，热门路由，流量摘要和性能洞察 |
连接后示例请求：
> "我的 TCXC 账户余额是多少？"
>
> "搜索前缀 44 的语音费率前 3 名运营商"
>
>土耳其的 数据包并购买的 5GB ## 快速入门
：安装 → 添加 TC凭证 → 连接 AI ### 1.需要 Python 3.10+ 和 [TelecomsXChange (TCXC)](https://www.telecomsxchange.com) 或 [NeuTRAFIX (NTX)](https://www.neutrafix.net) 账户。
```bash
# 克隆并导航
git clone https://github.com/TelecomsXChangeAPi/tcxc-mcp-server.git
cd tcxc-mcp-server
# 设置虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 从模板创建配置文件
cp .env.example .env
```
### 2. 添加 TCXC 凭证
从仪表盘获取 API 凭证：
- **TCXC**: [members.telecomsxchange.com](https://members.telecomsxchange.com) → 账户 → API 设置
- **NeuTRAFIX**: [members.neutrafix.net](https://members.neutrafix.net) → 账户 → API 设置
编辑 `.env`:
```env
# 买家凭证（必填）
TCXC_USERNAME=您的用户名
TCXC_API_KEY=您的 API 密钥
# 卖家凭证（必填）
TCXC_SELLER_USERNAME=您的卖家用户名
TCXC_SELLER_API_KEY=您的卖家 API 密钥
# API 端点
# NeuTRAFIX 用户：更改基准 URL 为 https://apiv2.neutrafix.net
TCXC_API_BASE_URL=https://apiv2.telecomsxchange.com
```
启动服务器需要同时提供买家和卖家凭证。
### 3. 连接 AI 客户端
服务器通过 stdio 使用标准 MCP，与所有主要 MCP 客户端兼容：
| AI 客户端 | 设置 |
|---|---|
| Claude Desktop | JSON 配置（如下） |
| Claude Code | `claude mcp add` 命令 |
| OpenAI Codex CLI | `codex mcp add` 命令 |
| Cursor | JSON 配置（如下） |
| 任意 MCP 客户端 | 指向 `start_mcp_server.sh` |
所有情况下，请使用 **绝对路径**，并在更改配置后重启客户端。
#### Claude Desktop
添加到配置文件：
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"tcxc": {
"command": "/绝对路径/to/tcxc-mcp-server/start_mcp_server.sh"
}
}
}
```
#### Claude Code (CLI)
```bash
claude mcp add tcxc /绝对路径/to/tcxc-mcp-server/start_mcp_server.sh
```
#### OpenAI Codex CLI
```bash
codex mcp add tcxc /绝对路径/to/tcxc-mcp-server/start_mcp_server.sh
```
或添加到 `~/.codex/config.toml`:
```toml
[mcp_servers.tcxc]
command = "/绝对路径/to/tcxc-mcp-server/start_mcp_server.sh"
```
#### Cursor
添加到 `~/.cursor/mcp.json`（或项目中的 `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"tcxc": {
"command": "/绝对路径/to/tcxc-mcp-server/start_mcp_server.sh"
}
}
}
```
#### 其他任意 MCP 客户端
指向包装脚本（从 `.env` 加载凭证）：
```
command: /绝对路径/to/tcxc-mcp-server/start_mcp_server.sh
```
或直接运行 Python 入口点并将凭证作为环境变量传递：
```
command: /绝对路径/to/tcxc-mcp-server/venv/bin/python
args: ["/绝对路径/to/tcxc-mcp-server/src/tcxc_mcp/server.py"]
env: TCXC_USERNAME, TCXC_API_KEY, TCXC_SELLER_USERNAME, TCXC_SELLER_API_KEY
```
## 独立运行
```bash
# 激活环境
source venv/bin/activate
# 启动服务器
./start_mcp_server.sh
# 或直接运行
python src/tcxc_mcp/server.py
```
## 测试
使用交互式客户端测试工具：
```bash
source venv/bin/activate
python src/tcxc_mcp/mcp_client.py
```
交互式命令：
- `list_tools` - 显示所有可用工具
- `call_tool <名称> <json 参数>` - 执行工具
- `list_prompts` - 显示引导工作流
- `get_prompt <名称> <json 参数>` - 获取工作流指导
## 可用工具
### 语音操作
```python
search_voice_market(prefix="1", route_type="CLI")
get_voice_destinations(country="United States")
list_call_records(date_from="2026-01-01", date_to="2026-01-31")
test_voice_route(i_account="123", cld1="+12125551234", cli1="+12025551234", i_connection1="8721", ...)
```
### 短信操作
```python
marketview_search_sms(prefix="44", country="United Kingdom")
buyers_smshistory(date_from="2026-01-01", date_to="2026-01-31")
buyers_sms_summary(date_from="2026-01-01", date_to="2026-01-31")
```
### DID 管理
```python
number_market(country="United States", did_type="mobile")
number_list(prefix="1")
number_purchase(i_did="12345", billing_i_account="123",sip:user@domain.com")
```
### eSIM 交换
```python
esim_countries()
esim_market(country="Turkey")
esim_purchase(i_esim_package="456", i_account="123")
esim_list()
esim_topup_list(iccid4500000000000000")
_topup_purchase(iccid="8944500000000", package_type_id="789", i123")
esim_orders="2026-01-01", date_to6-01-31")
```
### 财务和```python
buy()
seller_balance()
_payhistory(date_from="-01-01_to="2026-31")
buyers_account_list()
```
### 实用工具
```python
_lookup(number="+121", i_account="get_number_score="+12125551234_country_codes()
```
工具列表**：工具可用。详见 [工具文档](docs/.md)。
## 引导（提示）包含用于复杂任务提示：
- **search_best_voice_rates** - 查找和比较语音运营商
- **monitor_account_health** - 全面的账户健康检查
- **purchase_did_workflow** - 引导 DID 购买流程
- **analyze_call_quality** - CDR 分析和质量洞察
- **sms_market_res - 短信运营商比较
- **uting_setup** - 测试和验证电话路由
-_carriers** -商对比
在使用提示：“使用 monitor_account_health 提示检查我的 账户”
[PROMPTSPROMPTS.md 故障排除
###启动
```bash
环境变量
cat .env
```
确认所有四个凭证变量均已买家和卖家）。
### 身份验证```bash
# 直接测试凭证
curl -u "$TCXC_USERNAME:$TCXC_API_KEY" \
digest \
"$TCXC_API_BASE_URL/buyers/balance"
```
### 导入错误
```bash
# 重新安装依赖
pip install -r requirements.txt
# 用于 HTTP/2 支持
piphttpx[http```
### Claude Desktop
- 使用绝对路径（不使用 `~` 或相对路径）
- 在配置更改后重启 Claude Desktop
- 检查 Claude 日`tail -f ~/.config/claude.log`
##```bash
# 安装开发依赖
pip install -e ".[dev]"
# 格式化代码
make format
# 运行 linting
make lint
# 类型检查
make typecheck
# 运行测试
make test
```
## 架构
- **框架**：FastMCP（官方 MCP Python SDK）
- **HTTP 客户端**：HTTPX，支持 HTTP/2 和摘要认证
- **身份验证**：双账户支持（买家/卖家）
- **安全性**：输入验证、TLS 1.2+、速率限制
- **：异步/等待、连接池
## 安全性
- 凭证存储在 `.env` 中（从不提交到 git）
- 文件权限：`chmod 600 .env` 和 `chmod 700 start_mcp_server.sh`
- 所有输入在 API 调用前均已验证和净化
- 强制 TLS 验证（TLS 1.2+）
- 错误消息已净化，以防止信息泄露
详见CURITY.md](SECURITY.md)。
## 环境支持
**生产环境**https://apiv2.telecomsxchange.com`
- 实时计费和 provisioning
- 使用生产**沙盒环境**：联系 TCXC 支持团队盒端点
测试环境
- 无实际计费影响
## 常见问题
### 什么是 TCXC MCP 服务器？
TCXC MCP 服务器是一个开源的 Python 实现的 Model 服务器，它为 AI 助手提供直接、安全地sXChange 批发电信 API 的能力。与其编写 REST 集成代码，不如连接服务器到 ClaudeAI 或另一个 MCP，并用自然语言请求所需内容 — 搜索费率、测试语音购买 DID 号码或 eSIM、运行 H以及监控流量。它 55 种工具和 种引导工作，使用 HTTP Digest Authentication with TLS 1.2+，并在 API 调用前验证每个输入。
### AI 助手和兼容？
任何兼容 MCP 的客户端。已测试的配置包括 Claude Desktop、Claude Code（CLIAI Codex CLI。服务器通过标准io 通信，因此 的代理框架（如 OpenAI Agents SDK 和 Claude Agent SDK）也可以使用。
需要什么？样东西：Python 3.10 或更新TelecomsXChange 或 NeuTRAFIX 来自成员仪表盘 凭证（账户 →）。设置大约需要五分钟：克隆安装依赖、复制 `.env.example` 到 `.env`、添加凭证，并将服务器注册到 AI 客户端。
### 它与 NeuTRAFIX 兼容吗？的。NeuTRAFIX 运行相同的平台 API。在 `.env` 中设置 `TCXC_API_BASE_URL=https://apiv2.neut.net`，使用您的 NTX 凭证 —都相同。
### 使用它是免费的吗？
服务器本身是免费且 MIT 许可的。API 使用按标准市场费率由 TelecomsXChange 计费 — 通过工具进行的语音、短信、DID 和 eSIM 购买是您 TCXC 账户上的真实交易。
### AI 代理可以自主吗？
购买工具（`number_purchase`、`esim_purchase`、`esim_top`）对您的账户余额执行真实像 Claude Desktop 这样的 MCP 客户端默认情况下会在每次工具调用前请求您的批准；我们建议为账户管理工具保持启用。
### 它是如何确保安全的？
凭证存储在 `.env`（不会提交到并使用 HTTPS 通过 HTTP Digest Authentication 发送到 TC。客户端强制执行 TLS.2+，使用强密码套件出 API 端点和净化所有输入，限制请求速率，并从错误消息和日志离敏感数据。详见 [SECURITY.md](SECURITY.md)。
###sXChange？TelecomsXhttps://www.telecomsxchange.com) 是一个批发电信市场，授权运营商、运营商和通信服务提供商在此买卖语音终止、短信、 号码和 eSIM 数据包。买家获得具有质量指标（ASR/ACD）的路由定价家通过一个 API互连买家的基础。
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 文件
## 支持
- **问题**: [GitHub Issues](https://github.com/TelecomsXChangeAPi/t-mcp-server/issues)
- **TCXC 支持**: [telecomsxchange.com/contact](https://www.telecomsxchange.com/contact)
- **API 文档**: [apidocs.telecomsxchange.com](https://apidocs.telecomsxchange.com)
-盘**: [members.telecomsxchange.com](https://members.telecomsxchange.com)
## 贡献
欢迎贡献！请：
1. 分叉仓库
2. 创建功能分支
3. 进行更改测试
4. 提交拉取请求
---
**使用 ** [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) 构建 ** | **由 ** [
