🚀 FIWARE MCP 服务器
这是一个 FIWARE 模型上下文协议（MCP）服务器的首个实现，它在上下文代理和其他服务之间搭建了一座桥梁。该服务器实现了与上下文代理交互的基本操作，为后续开发奠定了基础。
🚀 快速开始
FIWARE MCP 服务器为上下文代理和其他服务提供交互桥梁。以下是快速启动服务器的步骤：
- 克隆此仓库：
git clone
cd FIWARE_MCP_01
- 安装所需的依赖项：
pip install -r requirements.txt
- 启动 MCP 服务器：
python server.py
# 或者
mcp run server.py
服务器将默认在 127.0.0.1:5001 上运行。
✨ 主要特性
- 上下文代理版本检查：可使用
CB_version工具检查上下文代理的版本。 - 上下文代理查询能力：通过
query_CB工具查询上下文代理。 - 实体发布和更新：利用
publish_to_CB工具发布或更新上下文代理中的实体。
📦 安装指南
先决条件
- Python 3.7 或更高版本
- pip（Python 包安装程序）
- 对 FIWARE 上下文代理实例的访问权限
安装步骤
- 克隆此仓库：
git clone
cd FIWARE_MCP_01
- 安装所需的依赖项：
pip install -r requirements.txt
Claude 桌面集成
mcp install server.py
# 自定义名称
mcp install server.py --name "FIWARE MCP 服务器"
# 环境变量，如果有
mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
mcp install server.py -f .env
💻 使用示例
基础用法
# 示例实体数据
entity_data = {
"id": "urn:ngsi-ld:TemperatureSensor:001",
"type": "TemperatureSensor",
"temperature": {
"type": "Property",
"value": 25.5
},
"@context": "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
}
# 发布到上下文代理
result = publish_to_CB(entity_data=entity_data)
可用工具
1. CB_version
- 功能：检查上下文代理的版本
- 默认参数：address="localhost"，port=1026
- 返回：包含版本信息的 JSON 字符串
2. query_CB
- 功能：查询上下文代理
- 参数：
- address（默认："localhost"）
- port（默认: 1026）
- query（默认: ""）
- 返回：查询结果的 JSON 字符串
3. publish_to_CB
- 功能：发布或更新上下文代理中的实体
- 参数：
- address（默认: "localhost"）
- port（默认: 1026）
- entity_data（必需：包含实体信息的字典）
- 返回：操作状态的 JSON 字符串
📚 详细文档
配置
通过修改 server.py 中的以下参数可以配置服务器：
- 主机地址
- 端口号
- 超时设置
错误处理
该服务器包含全面的错误处理功能，包括：
- 网络连接问题
- 上下文代理返回的无效响应
- 格式不正确的实体数据
- 服务端关闭
🔧 技术细节
目标
- 创建一个基本的 FIWARE MCP 服务端实现
- 提供上下文代理交互的简单工具
- 展示上下文代理的基本意图 CRUD 操作
- 作为更复杂的 MCP 实现的基础
📄 许可证
本项目根据 Apache License 2.0 许可。
🤝 贡献
欢迎提交问题和增强请求！