Congress Gov MCP

🚀 Congress.gov MCP服務器

你是否曾好奇美國國會在忙些什麼？是否厭倦了通過閱讀新聞來了解相關信息？現在，你可以直接向美國國會API詢問。這是一個非官方的 Congress.gov API MCP服務器。

🚀 快速開始

本項目提供了一個非官方的MCP服務器，用於訪問Congress.gov API，你可以通過它直接獲取美國國會的相關信息。

📦 安裝指南

通過Smithery安裝

若要通過 Smithery 自動為Claude Desktop安裝 congress_gov_mcp，請執行以下命令：

npx -y @smithery/cli install @AshwinSundar/congress_gov_mcp --client claude

手動安裝

前提條件

1. 安裝 uv。在macOS和Linux上，最簡單的方法是執行以下命令：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 獲取 Congress.gov API密鑰。
3. 安裝Claude Desktop、Claude Code或其他支持 MCP集成 的客戶端。

初始設置

1. 完成 前提條件。
2. 克隆本倉庫，並進入倉庫目錄：

   git clone http://github.com/AshwinSundar/congress_gov_mcp
   cd congress_gov_mcp
   

3. 安裝依賴：

   uv sync
   

4. 根據模板創建 .env 文件：

   cp .env.template .env
   

5. 將你的Congress.gov API密鑰添加到 .env 文件中：

   congress_gov_mcp/.env

   CONGRESS_GOV_API_KEY="your-api-key-here"
   

客戶端配置

Claude Desktop

1. 完成 前提條件。
2. 複製 uv 安裝的絕對路徑：

   which uv
   

3. 將以下內容添加到Claude Desktop配置文件的 mcpServers 塊中：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "congress_gov_mcp": {
         "command": "/absolute_path/to/uv",
         "args": [
           "run",
           "/absolute_path_to/congress_gov_mcp/server.py"
         ]
       }
     }
   }
   

Claude Code

1. 完成 前提條件。
2. 將以下內容添加到運行Claude Code的目錄下的 .mcp.json 文件的 mcpServers 塊中：

   {
     "mcpServers": {
       "congress_gov_mcp": {
         "command": "uv",
         "args": [
           "run",
           "/absolute_path_to/congress_gov_mcp/server.py"
         ]
       }
     }
   }
   

📚 詳細文檔

路線圖

• [x] api.congress.gov
  • [x] /bill
    • [x] /{congress}
    • [x] /{congress}/{billType}
    • [x] /{congress}/{billType}/{billNumber}
      • [ ] /actions
      • [ ] /amendments
      • [ ] /committees
      • [ ] /cosponsors
      • [ ] /relatedbills
      • [ ] /subjects
      • [ ] /summaries
      • [ ] /text
      • [ ] /titles
  • [x] /amendment
    • [x] /{congress}
    • [x] /{congress}/{amendmentType}
    • [x] /{congress}/{amendmentType}/{amendmentNumber}
      • [ ] /actions
      • [ ] /cosponsors
      • [ ] /amendments
      • [ ] /text
  • [x] /summaries
    • [x] /{congress}
    • [x] /{congress}/{billType}
  • [x] /congress
    • [x] /{congress}
    • [ ] /current
  • [x] /member
    • [x] /{bioguideId}
      • [ ] /sponsored-legislation
      • [ ] /cosponsored-legislation
  • [x] /committee
    • [x] /{systemCode}
      • [ ] /bills
      • [ ] /reports
      • [ ] /nominations
      • [ ] /meetings
      • [ ] /hearings
      • [ ] /house-communication
      • [ ] /senate-communication
  • [x] /committee-report
    • [x] /{congress}
    • [x] /{congress}/{reportType}
    • [x] /{congress}/{reportType}/{reportNumber}
      • [ ] /text
  • [x] /committee-print
    • [x] /{congress}
    • [x] /{congress}/{printType}
    • [x] /{congress}/{printType}/{printNumber}
      • [ ] /text
  • [x] /committee-meeting
    • [x] /{congress}
    • [x] /{congress}/{chamber}
      • [ ] /meetings
  • [x] /hearing
    • [x] /{congress}
    • [x] /{congress}/{chamber}
    • [x] /{congress}/{chamber}/{hearingNumber}
  • [x] /house-vote
    • [x] /{congress}
    • [x] /{congress}/{session}
    • [x] /{congress}/{session}/{rollCallNumber}
  • [x] /congressional-record
    • [x] /{volume}
    • [x] /{volume}/{pagePrefix}
    • [x] /{volume}/{pagePrefix}/{pageNumber}
  • [x] /daily-congressional-record
    • [x] /{volume}
    • [x] /{volume}/{issue}
  • [x] /bound-congressional-record
    • [x] /{year}
    • [x] /{year}/{month}
    • [x] /{year}/{month}/{day}
  • [x] /house-communication
    • [x] /{congress}
    • [x] /{congress}/{communicationType}
    • [x] /{congress}/{communicationType}/{communicationNumber}
  • [x] /house-requirement
    • [x] /{congress}
    • [x] /{congress}/{requirementNumber}
  • [x] /senate-communication
    • [x] /{congress}
    • [x] /{congress}/{communicationType}
    • [x] /{congress}/{communicationType}/{communicationNumber}
  • [x] /nomination
    • [x] /{congress}
    • [x] /{congress}/{nominationNumber}
      • [ ] /actions
      • [ ] /hearings
  • [x] /crsreport
    • [x] /{productCode}
  • [x] /treaty
    • [x] /{congress}
    • [x] /{congress}/{treatyNumber}
      • [ ] /actions
      • [ ] /committees