MuckRock MCP Server

用于与MuckRock的FOIA平台交互的模型上下文协议（MCP）服务器。

安装

pip install -r requirements.txt

配置

添加到Claude Desktop配置文件中 (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "muckrock": {
      "command": "/path/to/python",
      "args": ["/path/to/muckrock_server.py"]
    }
  }
}

认证

服务器启动时会提示输入MuckRock凭证。您也可以设置环境变量：

export MUCKROCK_USERNAME="your_username"
export MUCKROCK_PASSWORD="your_password"

功能

• 搜索 - 搜索FOIA请求和政府机构
• 提交请求 - 提交新的FOIA请求并自动选择组织
• 跟踪请求 - 查看已提交的请求及其状态
• 组织管理 - 管理提交请求的组织

使用方法

配置完成后，在Claude中使用自然语言：

• "搜索EPA的FOIA请求"
• "提交关于警察记录的FOIA请求"
• "显示我待处理的请求"
• "我可以提交到哪些组织？"

可用工具

• check_auth_status - 检查认证状态
• search_foia_requests - 搜索公共FOIA请求
• search_agencies - 查找政府机构
• get_foia_details - 获取请求详情
• get_my_user_info - 查看用户信息
• get_my_organizations - 列出您的组织
• file_foia_request_simple - 提交新的FOIA请求

注意事项

• 始终先使用测试机构进行测试（ID：248）
• 认证令牌会自动刷新
• 这是实验性软件，请自行承担风险

文档

请参阅docs/文件夹中的详细指南，包括认证、部署和使用案例。