MCP服务器

CAMARA FastMCP Server是一个完整的MCP服务器,支持所有10个CAMARA稳定API,并提供双版本支持(SPRING25/FALL25),适用于企业电信AI应用。

  • by laurentboutet
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 laurentboutet/MCP4CAMARA

使用说明

CAMARA FastMCP服务器

适用于所有10个CAMARA稳定API的完整MCP服务器,支持双版本(SPRING25/FALL25)

特性

✅ 15+MCP工具 -所有CAMARA稳定原料药
✅ 双版本 -SPRING25+FALL25自动切换
✅ 克劳德桌面版 -本地MCP集成
✅ 服务器模式 -远程部署就绪
✅ 生产就绪 -错误处理、日志记录、Docker/K8s支持

快速开始

1.安装

# Windows
setup.bat

# Linux/Mac
chmod +x setup.sh && ./setup.sh

2.配置

# Edit .env
CAMARA_BASE_URL=https://api.example-operator.com
CAMARA_API_KEY=your-bearer-token-here
CAMARA_VERSION=spring25  # or fall25

3.跑步

克劳德桌面模式(推荐): 看 CLAUDE_SETUP.md

服务器模式(远程):

python camara_final_complete.py --server --host 0.0.0.0 --port 8000

本地测试:

python camara_final_complete.py

支持的API

API系列 工具 弹簧25 FALL25
设备可达性 4工具 v1.0 v1.1
设备漫游 2个工具 v1.0 v1.1
位置 3个工具 v2.0 v3.0
号码验证 1个工具 v2.0 v2.1
OTP短信 1工具 v1.1 v1.1.1
QoS/QoD 2个工具 v1.0 v1.1
SIM卡交换 2个工具 v2.0 v2.1
简单边 1工具 v1.0 v2.0

看 API_REFERENCE.md 以获取完整的文档。

建筑

Browser/Claude → FastMCP Server → CAMARA Operators
                     ↓
              15 async tools
              26 API endpoints
              Bearer token auth

看 comparation.md 用于MCP与REST的比较。

环境变量

CAMARA_BASE_URL      # Operator API endpoint (required)
CAMARA_API_KEY       # Bearer token (required)
CAMARA_VERSION       # spring25 | fall25 (required)
CAMARA_TIMEOUT       # HTTP timeout in seconds (default: 30)

部署

码头工人

docker build -t camara-mcp .
docker run -p 8000:8000 --env-file .env camara-mcp

Kubernetes

kubectl apply -f k8s/camara-deployment.yaml

请参阅中的部署指南 docs/.

使用示例

克劳德桌面版

"Check if +33612345678 is reachable"
"Create geofencing for +33612345678 around Paris"
"Verify number +33612345678"

开发包

from mcp import Client
client = Client("http://localhost:8000")
result = client.call_tool("device_reachability_status", 
                         {"phone_number": "+33612345678"})

故障排除

Claude桌面问题

看 CLAUDE_SETUP.md

服务器问题

# Test configuration
python camara_final_complete.py --test

# Enable debug logging
export MCP_LOG_LEVEL=debug

贡献

基于CAMARA GitHub官方仓库:

  • 设备可访问性状态 (r1.2/r3.2)
  • 设备位置(r2.2/r3.2)
  • 编号验证(r2.4/r3.2)
  • SimSwap(r2.2/r3.3)
  • 还有6个。..

许可证

MIT许可证-请参阅许可证文件

支持

  • CAMARA项目: https://github.com/camaraproject
  • FastMCP: https://github.com/jlowin/fastmcp
  • 问题: GitHub问题

用于企业电信人工智能应用的生产就绪CAMARA MCP服务器