美国国会数据MCP服务器

# Clone the repository
git clone https://github.com/yourusername/congress-mcp.git
cd congress-mcp

# Install with pip
pip install -e .

# Or install with development dependencies
pip install -e ".[dev]"

export CONGRESS_API_KEY=your_api_key_here

cp .env.example .env
# Edit .env with your API key

# API base URL (default: https://api.congress.gov/v3)
export CONGRESS_API_BASE_URL=https://api.congress.gov/v3

# Default pagination limit (default: 20)
export CONGRESS_DEFAULT_LIMIT=20

# Maximum pagination limit (default: 250)
export CONGRESS_MAX_LIMIT=250

# Request timeout in seconds (default: 30)
export CONGRESS_TIMEOUT=30.0

claude mcp add --scope local --transport http congress-mcp-an https://congress-mcp-an.fastmcp.app/mcp

claude mcp add congress-mcp --env CONGRESS_API_KEY=your_api_key

{
  "congress-mcp-an": {
    "url": "https://congress-mcp-an.fastmcp.app/mcp"
  }
}

codex mcp add --url https://congress-mcp-an.fastmcp.app/mcp congress-mcp-an

# Using the installed command
congress-mcp

# Or using FastMCP directly
fastmcp run src/congress_mcp/server.py

# List the most recently introduced bills from the 118th Congress
list_bills(congress=118, sort="introducedDate+desc", limit=10)

# Search bills by title keyword and/or policy area (filters client-side)
search_bills(congress=118, query="veteran", bill_type="hr", max_matches=10)

# Policy area search costs one request per bill checked; max_scan caps it
search_bills(congress=118, policy_area="Health", query="Medicare", bill_type="hr",
             max_scan=100)

# Get a specific bill
get_bill(congress=118, bill_type="hr", bill_number=1)

# Get bill cosponsors
get_bill_cosponsors(congress=118, bill_type="hr", bill_number=1)

# Get bill text versions
get_bill_text(congress=118, bill_type="s", bill_number=1234)

# List current members
list_members(current_member=True, limit=50)

# Get member by bioguide ID
get_member(bioguide_id="P000197")

# Get legislation sponsored by a member
get_member_sponsored_legislation(bioguide_id="P000197")

# List members from California
list_members_by_state(state="CA", current_member=True)

# List all committees
list_committees()

# Get House Judiciary Committee
get_committee(chamber="house", committee_code="hsju00")

# Get committee's bills
get_committee_bills(chamber="house", committee_code="hsju00")

# List nominations in 118th Congress
list_nominations(congress=118)

# Get nomination details
get_nomination(congress=118, nomination_number=1064)

# Get nomination hearings
get_nomination_hearings(congress=118, nomination_number=1064)

# List treaties
list_treaties(congress=118)

# Get treaty details
get_treaty(congress=118, treaty_number=3)

# Search bill summaries by keyword (handles pagination internally)
search_summaries(congress=118, query="artificial intelligence", bill_type="hr",
                 from_date="2024-01-01", to_date="2024-12-31", max_matches=10)

# List recent summaries
list_summaries(limit=10)

# List summaries for a specific Congress
list_summaries_by_congress(congress=118, from_date="2024-01-01", to_date="2024-12-31")

# List House votes
list_house_votes(congress=118, session=1)

# Get specific vote
get_house_vote(congress=118, session=1, roll_call_number=100)

# Get how members voted
get_house_vote_members(congress=118, session=1, roll_call_number=100)

# API information
congress://api/info

# Bill type codes
congress://enums/bill-types

# Congress number reference
congress://reference/congress-numbers

# Direct bill access
congress://bill/118/hr/1

# Direct member access
congress://member/P000197

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=congress_mcp

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy src/