MuckRock MCP Server

MuckRock MCP Server

MuckRock の FOIA プラットフォームを操作するための Model Context Protocol（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/ フォルダーを参照してください。