金大哥 - us-legal-mcp MCP 详情

article

README

🚀 美国法律MCP服务器

这是一个全面的模型上下文协议（MCP）服务器，专为美国法律数据而设计。它提供了对国会法案、联邦公报文件、法院判决意见以及委员会数据的访问途径，能有效满足用户在法律信息检索方面的需求。

✨ 主要特性

📜 国会官网集成

搜索法案和决议
获取近期立法信息
获取委员会信息
提供实时立法数据

📋 联邦公报集成

搜索法规和行政命令
获取近期政府机构文件
提供完整文档文本和元数据

⚖️ 法院判决数据库集成

搜索法院判决意见（联邦和州法院）
获取近期法院判决结果
访问最高法院、上诉法院和州法院数据
提供完整案件文本和元数据

🗳️ 国会委员会

获取委员会信息
按议院（众议院/参议院）筛选
跟踪立法活动

🚀 快速开始

安装

npm install
npm run build

环境变量（可选）

# 用于增强对国会官网的访问（有免费套餐）
export CONGRESS_API_KEY="your_congress_api_key"

# 用于访问法院判决数据库API（有免费套餐）
export COURT_LISTENER_API_KEY="your_court_listener_api_key"

启动服务器

npm start

MCP配置（Cursor/Claude）

要将此MCP服务器与Cursor或Claude桌面版一起使用，请添加以下配置：

对于Cursor

创建或编辑 ~/.cursor/mcp.json（或你的Cursor MCP配置文件位置）：

{
  "mcpServers": {
    "us-legal-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/legal-mcp/dist/index.js"],
      "env": {
        "CONGRESS_API_KEY": "",
        "COURT_LISTENER_API_KEY": "258021eb4dd1901f1acfdb3f521fb8a7837a9097"
      }
    }
  }
}

重要提示：请将 /absolute/path/to/legal-mcp 替换为你实际的项目路径。

对于Claude桌面版

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "us-legal-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/legal-mcp/dist/index.js"],
      "env": {
        "CONGRESS_API_KEY": "",
        "COURT_LISTENER_API_KEY": "258021eb4dd1901f1acfdb3f521fb8a7837a9097"
      }
    }
  }
}

请参考本仓库中的 mcp-config-example.json 以获取参考配置。

🛠️ 可用工具

`search-congress-bills`

在国会官网搜索法案和决议

查询：搜索关键词（例如：“移民”、“医疗保健”）
国会届数：可选的国会届数（100 - 120）
结果数量：结果数量（1 - 50）

`search-federal-register`

搜索联邦公报文件（法规、行政命令）

查询：搜索关键词
结果数量：结果数量（1 - 50）

`search-all-legal`

在所有可用数据源（国会法案、联邦公报、法院判决意见）中进行综合搜索

查询：搜索关键词
结果数量：每个数据源的结果数量（1 - 50）

`get-recent-bills`

获取近期提出的法案

国会届数：可选的国会届数
结果数量：结果数量（1 - 50）

`get-recent-regulations`

获取近期发布的联邦公报文件

结果数量：结果数量（1 - 50）

`search-court-opinions`

搜索法院判决意见和裁决

查询：搜索关键词（例如：“宪法”、“版权”）
法院：可选的法院筛选条件（例如：“最高法院”、“第一巡回上诉法院”、“第二巡回上诉法院”）
结果数量：结果数量（1 - 50）

`get-recent-court-opinions`

获取最近发布的法院判决意见

法院：可选的法院筛选条件
结果数量：结果数量（1 - 50）

`get-congress-committees`

获取国会委员会列表

国会届数：可选的国会届数（100 - 120）
议院：可选的筛选条件（“众议院” 或 “参议院”）

📊 数据源

| 属性 | 详情 | |------|------| | 数据源 | 描述 | API | 是否需要认证 | 状态 | | 国会官网 | 法案、决议、委员会 | https://api.congress.gov/v3 | 可选 | ✅ | | 联邦公报 | 法规、行政命令 | https://www.federalregister.gov/api/v1 | 否 | ✅ | | 法院判决数据库 | 法院判决意见、裁决 | https://www.courtlistener.com/api/ | 可选 | ✅ |

注意：由于API可靠性问题，美国法典和法规官网的集成已被移除。

🔑 API密钥

国会官网API密钥（可选）

访问 https://api.congress.gov/
注册免费账户
获取你的API密钥
设置 CONGRESS_API_KEY 环境变量

法院判决数据库API密钥（可选）

访问 https://www.courtlistener.com/api/
创建免费账户
从你的个人资料中获取API密钥
设置 COURT_LISTENER_API_KEY 环境变量

注意：示例MCP配置文件中包含了一个预配置的API密钥，方便你快速设置。

💻 使用示例

基础用法

// 搜索移民法案
{
  "tool": "search-congress-bills",
  "arguments": {
    "query": "immigration",
    "congress": 118,
    "limit": 10
  }
}

高级用法

// 在所有数据源中进行综合搜索
{
  "tool": "search-all-legal",
  "arguments": {
    "query": "healthcare",
    "limit": 20
  }
}

捐赠

如果您觉得这个项目很有用，欢迎通过以下方式进行捐赠支持：

⚡ 闪电网络 lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ 链上比特币 bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ 以太坊 / EVM网络 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f

来自任何与EVM兼容的网络（以太坊、Polygon、Arbitrum、Optimism、币安智能链、雪崩等）的捐赠都将顺利到账！您还可以向此地址发送USDT、USDC、DAI等ERC - 20代币。

📝 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

🤝 贡献

欢迎大家贡献代码！请阅读贡献指南并提交拉取请求。

us-legal-mcp