AI导哈

政府数据查询服务

一个通过Socrata API提供马里兰州公开数据访问的MCP服务器，专注于州政府支出、支付和公共记录，适用于竞选财务和政治影响研究。

  • by christyfrink
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 christyfrink/mcp-maryland-opendata

使用说明

MCP马里兰开放数据服务器

一种模型上下文协议（MCP）服务器，通过Socrata API提供对马里兰开放数据的访问。专注于对竞选财务和政治影响力研究有用的州政府支出、付款和公共记录。

特性

  • 搜索州付款 按供应商、代理机构、财政年度或金额
  • 获取累计付款总额 按供应商或代理机构分组
  • 查询任何马里兰开放数据集 使用SoQL
  • 不需要API密钥 （支持匿名访问）
  • 模糊搜索的部分名称匹配
  • 对大型结果集的分页支持

需求

  • Node.js（v16或更高版本）

不需要API密钥，但您可以选择在注册应用令牌 索克拉塔 对于更高的速率限制。

安装

  1. 克隆存储库：
git clone https://github.com/christyfrink/mcp-maryland-opendata
cd mcp-maryland-opendata
  1. 安装依赖项：
npm install
  1. 构建服务器：
npm run build

配置

要将此MCP服务器与Claude代码一起使用，请添加到您的Claude配置中：

{
  "mcpServers": {
    "maryland-opendata": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maryland-opendata/build/server.js"]
    }
  }
}

可用工具

州支付工具

  • search_state_payments：按供应商名称、机构、财政年度或金额范围搜索马里兰州的付款。涵盖2008-2024财年，约有390000份付款记录。

  • get_vendor_payment_totals：获取按供应商或代理机构分组的汇总付款总额。可用于查找顶级供应商或分析支出模式。

通用查询工具

  • query_dataset：对任何马里兰开放数据集执行自定义SoQL查询。用于特定工具未涵盖的高级查询。

  • get_dataset_info：获取有关数据集的元数据，包括列名、类型和描述。

  • list_available_datasets：列出竞选财务和政府支出研究常用的数据集。

关键数据集

数据集ID 名称 用例
7syw-q4cy 国家支付（2008-2024财年） 将捐助者与供应商进行交叉参考，分析机构支出
x8qy-486w 州全职员工（2017-2026财年） 跟踪人员配置水平、工资支出
t6vk-rvwe 学校董事会支出 教育承包商分析

查询示例

查找对特定供应商的付款：

search_state_payments with vendor_name: "Venable"

2023财年按付款总额计算的顶级供应商：

get_vendor_payment_totals with group_by: "vendor", fiscal_year: 2023, limit: 20

机构支出分析：

get_vendor_payment_totals with group_by: "agency", fiscal_year: 2023

自定义SoQL查询：

query_dataset with dataset_id: "7syw-q4cy",
  where: "amount > 1000000",
  order: "amount DESC",
  limit: 50

速率限制

服务器对匿名访问实施了保守的速率限制（500个请求/小时）。如需更高的限额，请注册Socrata应用代币。

调查用例

该MCP旨在支持竞选财务研究：

  1. 捐助者与供应商匹配：将活动参与者与州付款接受者进行交叉引用
  2. 时序分析：将付款日期与捐赠日期进行比较
  3. 代理模式：确定哪些机构向哪些供应商付款
  4. 律师事务所分析：跟踪国家支付的法律费用

发展

要修改服务器，请执行以下操作：

  1. 在中更改TypeScript文件 src/
  2. 重建：
npm run build

许可证

MIT许可证

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

相关 MCP