MCP马里兰开放数据服务器
一种模型上下文协议（MCP）服务器，通过Socrata API提供对马里兰开放数据的访问。专注于对竞选财务和政治影响力研究有用的州政府支出、付款和公共记录。
特性
- 搜索州付款 按供应商、代理机构、财政年度或金额
- 获取累计付款总额 按供应商或代理机构分组
- 查询任何马里兰开放数据集 使用SoQL
- 不需要API密钥 （支持匿名访问）
- 模糊搜索的部分名称匹配
- 对大型结果集的分页支持
需求
- Node.js（v16或更高版本）
不需要API密钥，但您可以选择在注册应用令牌 索克拉塔 对于更高的速率限制。
安装
- 克隆存储库：
git clone https://github.com/christyfrink/mcp-maryland-opendata
cd mcp-maryland-opendata- 安装依赖项：
npm install- 构建服务器：
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旨在支持竞选财务研究：
- 捐助者与供应商匹配：将活动参与者与州付款接受者进行交叉引用
- 时序分析：将付款日期与捐赠日期进行比较
- 代理模式：确定哪些机构向哪些供应商付款
- 律师事务所分析：跟踪国家支付的法律费用
发展
要修改服务器，请执行以下操作：
- 在中更改TypeScript文件
src/ - 重建：
npm run build许可证
MIT许可证
贡献
- 分叉存储库
- 创建功能分支
- 提交您的更改
- 推到分支
- 创建拉取请求