MuckRock MCP Server

MuckRock MCP 服务

用于与 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/ 文件夹。