使用说明
项目简介
DataGov MCP Server 是一个轻量级的 MCP 服务器实现,它使用 Flask 框架搭建,专注于将以色列政府公共数据 API (data.gov.il) 封装成可被 LLM 客户端调用的函数。该项目包含服务端和客户端示例,展示了如何通过 MCP 协议,让 LLM 应用安全、便捷地获取外部数据。
主要功能点
- 数据访问能力: 通过 'fetch_data_gov_il' 函数,允许 LLM 客户端查询和获取以色列政府公共数据 API 的数据集。
- 函数注册与执行: 实现了 MCP 协议规定的函数列表和执行端点,支持客户端发现和调用预定义的数据查询函数。
- 基于 Flask 的服务端: 使用 Flask 框架搭建,易于理解和扩展。
- OpenAI 客户端示例: 提供了一个集成了 OpenAI API 的客户端示例,演示了如何与 MCP 服务器交互并利用 LLM 进行数据查询。
安装步骤
- 克隆仓库:
git clone https://github.com/aviveldan/datagov-mcp cd datagov-mcp - 安装依赖:
pip install -r requirements.txt - 配置 OpenAI API 密钥 (可选):
如果需要运行客户端示例,请设置 OpenAI API 密钥:
export OPENAI_API_KEY="your-api-key-here"
MCP 客户端配置
MCP 客户端需要配置以下信息以连接到 DataGov MCP 服务器。以下为 JSON 格式的配置信息示例,请根据实际情况调整:
{ "serverName": "datagov-mcp-server", "command": "python", "args": ["server.py"], "transport": "http", "uri": "http://localhost:8080/mcp" }
配置参数说明:
- 'serverName': 服务器的名称,可以自定义。
- 'command': 启动服务器的命令,这里使用 'python'。
- 'args': 启动服务器命令的参数,这里指定运行 'server.py' 文件。
- 'transport': 传输协议,这里使用 'http'。
- 'uri': MCP 服务器的根 URI,客户端将通过此 URI 与服务器通信。
基本使用方法
-
启动 MCP 服务器: 在终端中,进入仓库目录并运行服务器:
python server.py服务器将运行在 'http://localhost:8080'。
-
运行客户端示例 (可选): 在另一个终端中,进入仓库目录并运行客户端:
python client.py客户端会连接到 MCP 服务器,获取可用函数,并使用 OpenAI 模型进行交互,演示如何调用 'fetch_data_gov_il' 函数查询以色列政府公共数据。
注意: 运行客户端示例需要配置 OpenAI API 密钥。
信息
分类
网页与API