使用说明

项目简介

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 进行数据查询。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/aviveldan/datagov-mcp
    cd datagov-mcp
  2. 安装依赖:
    pip install -r requirements.txt
  3. 配置 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 与服务器通信。

基本使用方法

  1. 启动 MCP 服务器: 在终端中,进入仓库目录并运行服务器:

    python server.py

    服务器将运行在 'http://localhost:8080'。

  2. 运行客户端示例 (可选): 在另一个终端中,进入仓库目录并运行客户端:

    python client.py

    客户端会连接到 MCP 服务器,获取可用函数,并使用 OpenAI 模型进行交互,演示如何调用 'fetch_data_gov_il' 函数查询以色列政府公共数据。

    注意: 运行客户端示例需要配置 OpenAI API 密钥。

信息

分类

网页与API