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: 搜索和列出数据集
  • categories: 列出数据集类别
  • tags: 列出数据集标签
  • dataset-metadata: 获取数据集详细信息
  • column-info: 获取数据集列信息
  • data-access: 查询和检索记录
  • site-metrics: 获取门户统计信息

• domain (字符串，可选): 数据门户主机名（不带协议）

• query (字符串，可选): 数据集搜索查询

• datasetId (字符串): 用于特定操作的数据集标识符

• soqlQuery (字符串，可选): 用于过滤数据的 SoQL 查询

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

• offset (数字，可选): 要跳过的结果数，用于分页（默认值：0）

示例查询

以下是 Claude Desktop 如何格式化对 MCP 服务器的查询的示例：

// 查找有关预算的数据集
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// 获取有关数据集的信息
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// 使用类似 SQL 的语法查询数据集记录
{
  "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