OpenGov MCP Server

OpenGov MCP 服务

一个 MCP（Model Context Protocol）服务，可让 Claude Desktop 等 MCP 客户端访问 Socrata Open Data 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 中提出如下问题：

   How many cars were towed in Chicago this month?
   

   还可以继续提问，深入了解更多细节：

   Which make and color were towed the most?
   Also, were there any interesting vanity plates?
   

   首次运行查询时，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：搜索并列出数据集
  • categories：列出数据集类别
  • tags：列出数据集标签
  • dataset-metadata：获取数据集详情
  • column-info：获取数据集列信息
  • data-access：查询并检索记录
  • site-metrics：获取门户统计信息

• domain（字符串，可选）：数据门户主机名（不含协议）

• query（字符串，可选）：用于搜索数据集的查询

• datasetId（字符串）：特定操作所需的数据集标识符

• soqlQuery（字符串，可选）：用于筛选数据的 SoQL 查询

• limit（数字，可选）：要返回的最大结果数（默认值：10）

• offset（数字，可选）：分页时要跳过的结果数（默认值：0）

查询示例

以下是 Claude Desktop 向 MCP 服务发送查询时使用的格式示例：

// Find datasets about budgets
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// Get information about a dataset
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// Query dataset records with SQL-like syntax
{
  "type": "data-access",
  "datasetId": "6zsd-86xi",
  "soqlQuery": "SELECT * WHERE amount > 1000 ORDER BY date DESC",
  "limit": 10
}

配置选项

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

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

可以通过以下方式设置：

• 在 Claude Desktop 配置中（推荐）
• 在环境变量中
• 通过命令行：DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server