Congressmcp

# just for you
claude mcp add congressmcp --env CONGRESS_API_KEY=your-api-key-here -- uvx congressmcp

# shared with your team via .mcp.json in the repo root
claude mcp add --scope project congressmcp --env CONGRESS_API_KEY='${CONGRESS_API_KEY}' -- uvx congressmcp

如所示，把服务名称放在 --env 之前 — 如果 --env 在前，CLI 会尝试把名称解析为另一个 KEY=value 对。等价的 .mcp.json：

{
  "mcpServers": {
    "congressmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${CONGRESS_API_KEY}" }
    }
  }
}

${VAR} / ${VAR:-default} 会从你的环境展开，因此密钥无需提交到版本库。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "congress-api-key",
      "description": "Congress.gov API key",
      "password": true
    }
  ],
  "servers": {
    "congressmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${input:congress-api-key}" }
    }
  }
}

VS Code 在服务首次启动时会显示信任提示。

codex mcp add congressmcp --env CONGRESS_API_KEY=your-api-key-here -- uvx congressmcp

或在 ~/.codex/config.toml 中（Codex IDE 扩展和 ChatGPT 桌面应用也会读取该文件；项目级 .codex/config.toml 在受信任的项目中可用）：

[mcp_servers.congressmcp]
command = "uvx"
args = ["congressmcp"]
env_vars = ["CONGRESS_API_KEY"]   # forward from your shell — nothing secret in the file

若要改为内联密钥，请将 env_vars 行替换为包含 CONGRESS_API_KEY = "…" 的 [mcp_servers.congressmcp.env] 表。可用 codex mcp list 或在会话内使用 /mcp 进行检查。

全局：~/.cursor/mcp.json。按项目：.cursor/mcp.json。

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${env:CONGRESS_API_KEY}" }
    }
  }
}

${env:NAME} 从你的 shell 环境读取；直接使用密钥字符串也可以。

AI Assistant：设置 → Tools → AI Assistant → Model Context Protocol (MCP) → Add → As JSON，然后粘贴 Claude Desktop 配置块（还有一个 Import from Claude 按钮，可读取 claude_desktop_config.json）。

Junie：设置 → Tools → Junie → MCP Settings，它会编辑 ~/.junie/mcp/mcp.json（全局）或 .junie/mcp/mcp.json（项目）——同样是 mcpServers 结构。

全局 ~/.config/opencode/opencode.json 或项目根目录的 opencode.json / opencode.jsonc（项目配置覆盖全局）。OpenCode 将命令及其参数放在同一个数组中，并将环境变量映射称为 environment：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "congressmcp": {
      "type": "local",
      "command": ["uvx", "congressmcp"],
      "environment": { "CONGRESS_API_KEY": "your-api-key-here" },
      "enabled": true
    }
  }
}

没有 opencode mcp add；编辑文件后，用 opencode mcp list / opencode mcp debug congressmcp 检查。远程服务使用 "type": "remote", "url": "https://<host>/mcp"。

gemini mcp add -s user -e CONGRESS_API_KEY=your-api-key-here congressmcp uvx congressmcp

（-s user 使其成为全局配置；默认作用域为当前项目。）或在 ~/.gemini/settings.json / .gemini/settings.json 中：

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "$CONGRESS_API_KEY" }
    }
  }
}

Claude 菜单 → Settings… → Developer → Edit Config，或直接编辑文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" }
    }
  }
}

重启 Claude Desktop。如果服务未出现，请使用 uvx 的绝对路径（which uvx / where uvx）——GUI 应用并不总能继承你 shell 的 PATH。日志：~/Library/Logs/Claude/mcp*.log 或 %APPDATA%\Claude\logs。

Cascade 面板 → MCPs 图标 → 原始配置，或编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "${env:CONGRESS_API_KEY}" }
    }
  }
}

Windsurf 将所有服务的工具总数上限设为 100；CongressMCP 注册了 24 个（每个打包了相关操作），因此完全能容纳。

设置 → AI → MCP Servers → Add Local Server，或编辑 settings.json（macOS ~/Library/Application Support/Zed/settings.json、Linux ~/.config/zed/settings.json、Windows %APPDATA%\Zed\settings.json；项目级 .zed/settings.json）：

{
  "context_servers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" }
    }
  }
}

Cline：MCP Servers 图标 → Configure → Configure MCP Servers（打开 cline_mcp_settings.json；Cline 命令行使用 ~/.cline/mcp.json）。 Roo Code：MCP Servers → Edit Global MCP，或按项目使用 .roo/mcp.json。

两者都使用 Claude Desktop 的结构，外加几个客户端专属字段：

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": { "CONGRESS_API_KEY": "your-api-key-here" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

在 Windows 上，Roo 的文档建议包装该命令："command": "cmd", "args": ["/c", "uvx", "congressmcp"]。

交互式：goose configure → Add Extension → Command-line Extension（命令 uvx congressmcp，然后在提示输入环境变量时添加 CONGRESS_API_KEY）。一次性：goose session --with-extension "CONGRESS_API_KEY=your-api-key-here uvx congressmcp"。或在 ~/.config/goose/config.yaml 中：

extensions:
  congressmcp:
    name: congressmcp
    type: stdio
    cmd: uvx
    args: [congressmcp]
    envs: { "CONGRESS_API_KEY": "your-api-key-here" }
    enabled: true
    timeout: 300

xAI 的终端编码 Agent。如果你已经为 Claude Code（~/.claude.json / .mcp.json）或 Cursor（.cursor/mcp.json）配置了 CongressMCP，Grok Build 会自动读取 — 无需再做其他操作。否则：

grok mcp add congressmcp -- uvx congressmcp      # add --scope project for .grok/config.toml

然后在 ~/.grok/config.toml（或项目 .grok/config.toml）中设置密钥：

[mcp_servers.congressmcp]
command = "uvx"
args = ["congressmcp"]
env = { CONGRESS_API_KEY = "${CONGRESS_API_KEY}" }

用 grok mcp list / grok mcp doctor congressmcp 进行验证；会话中的 /mcps 可切换服务。工具显示为 congressmcp__<tool>。

Nous Research 的 Hermes Agent。~/.hermes/config.yaml：

mcp_servers:
  congressmcp:
    command: "uvx"
    args: ["congressmcp"]
    env:
      CONGRESS_API_KEY: "${CONGRESS_API_KEY}"   # or a literal key
    enabled: true

或运行 hermes mcp add congressmcp --command uvx --args congressmcp，然后手动添加 env: 块。hermes mcp test congressmcp 检查连接；会话中的 /reload-mcp 无需重启即可重新加载。工具显示为 mcp__congressmcp__<tool>。

openclaw mcp add congressmcp --command uvx --arg congressmcp --env CONGRESS_API_KEY=your-api-key-here

或在 ~/.openclaw/openclaw.json 中的 mcp.servers 下（JSON5，因此注释和尾随逗号均可）：

{
  mcp: {
    servers: {
      congressmcp: {
        command: "uvx",
        args: ["congressmcp"],
        env: { CONGRESS_API_KEY: "your-api-key-here" },
      },
    },
  },
}

用 openclaw mcp status / openclaw mcp probe congressmcp 进行验证。OpenClaw 不读取 mcporter 的注册表 — 请使用 mcp.servers。对于远程服务，使用 url 并显式指定 transport: "streamable-http"。

~/.continue/config.yaml，或在工作区 .continue/mcpServers/ 下为每个服务放置一个文件（Continue 也接受放入该文件夹的 Claude/Cursor 风格 JSON 文件）。MCP 工具在 agent 模式下可用。

mcpServers:
  - name: congressmcp
    type: stdio
    command: uvx
    args:
      - congressmcp
    env:
      CONGRESS_API_KEY: ${{ secrets.CONGRESS_API_KEY }}

Program 标签页 → Install → Edit mcp.json。LM Studio 遵循 Cursor 的 mcp.json 格式，因此 Cursor 块可直接使用 — 请使用字面键字符串而非 ${env:…}。这使任何支持工具调用的本地模型都能访问国会数据。

这些客户端无法启动本地进程；它们通过 URL 连接到 MCP 服务。以 HTTP 模式运行 CongressMCP，并将 URL 提供给它们：

• ChatGPT（Plus/Pro/Business/Enterprise/Edu，网页版）：Settings → Security and login → Developer mode，然后使用你的服务 URL 添加连接器。需要公共 HTTPS 端点（或 Secure MCP Tunnel）。
• Claude.ai（网页版；同步到移动端）：Customize → Connectors → Add custom connector（Team/Enterprise：Organization settings → Connectors）。必须可通过公共互联网访问。
• Open WebUI：Admin Settings → Integrations → + Add Server → MCP (Streamable HTTP)。仅支持 Streamable HTTP；可位于你的局域网内。

每种情况下的端点均为 https://<your-host>/mcp。上面的大多数本地客户端（OpenCode、Grok Build、Hermes、OpenClaw、Codex、Claude Code、Cursor、VS Code）也可以连接到该 URL，而非启动 uvx — 这对于在团队中共享一个安装非常有用。