opengov-mcp-server

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" } } } }
   您可以用任何由 Socrata 提供支持的数据门户替换 DATA_PORTAL_URL。
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 桌面配置：在您的主目录中创建或编辑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 服务器的查询的示例：

配置选项

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

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

可以这样设置：

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