OpenGov MCP 服务器

一个 MCP（模型上下文协议）服务器，使像Claude Desktop这样的MCP客户端能够访问Socrata开放数据API。此集成允许Claude Desktop搜索、检索和分析来自政府数据门户的公共数据集。

概述

该 MCP 服务器提供对任何 Socrata 支持的数据门户（包括城市、州和联邦机构）的开放数据访问，例如：

• 芝加哥
• 纽约市
• 旧金山
• 洛杉矶
• 以及其他政府机构

基本使用不需要 API 密钥，因为服务器访问公共数据。

功能

使用此 MCP 服务器，客户端可以：

• 搜索和发现数据集，按关键字、类别或标签
• 查看数据集元数据和列信息
• 运行类似 SQL 的查询以检索和分析数据
• 获取门户使用统计信息

在Claude Desktop上的安装

使用 npx 的快速设置（推荐）

使用此 MCP 服务器的最简单方法是通过 npx，它不需要任何安装：

1. 创建或编辑你的Claude Desktop配置：

   创建或编辑用户主目录中的 claude_desktop_config.json 文件：

   {
     "mcpServers": { 
       "opengov": {
         "command": "npx",
         "args": ["-y", "opengov-mcp-server@latest"],
         "env": {
           "DATA_PORTAL_URL": "https://data.cityofchicago.org"
         }
       }
     }
   }
   

   你可以将 DATA_PORTAL_URL 替换为任何 Socrata 支持的数据门户。

2. 重新启动Claude Desktop（如果已经在运行）

3. 开始使用MCP服务器：

   在 Claude Desktop 中，现在你可以询问如下问题：

   本月芝加哥有多少辆汽车被拖走？
   

   并且你可以继续提出更深入的问题进行进一步分析：

   哪种品牌和颜色的汽车被拖走最多？
   还有吗？是否有任何有趣的车牌号码？
   

   第一次运行查询时，npx 会自动下载并运行最新版本的服务器。

从源代码手动安装（用于开发或自定义）

如果你希望从源代码运行（用于开发或自定义）：

1. 克隆此仓库：

   git clone https://github.com/srobbin/opengov-mcp-server.git
   cd opengov-mcp-server
   

2. 安装依赖项并构建：

   npm install
   npm run build
   

3. 创建Claude Desktop配置：

   创建或编辑用户主目录中的 claude_desktop_config.json 文件：

   {
     "mcpServers": { 
       "opengov": {
         "command": "node",
         "args": [
           "/path/to/your/opengov-mcp-server/dist/index.js"
         ],
         "env": {
           "DATA_PORTAL_URL": "https://data.cityofchicago.org"
         }
       }
     }
   }
   

   将 /path/to/your/opengov-mcp-server 替换为你克隆仓库的实际路径。

4. 重新启动Claude Desktop（如果已经在运行）

可用工具：get_data

此 MCP 服务器提供一个统一的 get_data 工具，Claude Desktop 使用该工具访问 Socrata 数据。

参数

• type (字符串，必需)：操作类型

  • catalog：搜索和列出数据集
  • metadata：获取特定数据集的元数据
  • data-access：检索数据集记录

• datasetId (字符串，必需)：要操作的数据集的 ID

配置选项

服务器需要一个环境变量：

• DATA_PORTAL_URL：Socrata 数据门户 URL（例如，https://data.cityofchicago.org）

这个变量可以设置为：

• 在Claude Desktop配置中（推荐）
• 在你的环境变量中
• 通过命令行：`DATA_PORTAL_URL=https://data