lawstronaut-mcp

<div align="center"> <img src="./assets/lawstronaut-icon.png" width="100" alt="lawstronaut logo" /> # Lawstronaut MCP 将 [lawstronaut](https://mcp.lawstronaut.com) 连接到 Claude、ChatGPT、Cursor 和任何支持 [模型上下文协议](https://modelcontextprotocol.io) 的 AI 代理。 将您的 AI 连接到 50 多万个法律和法院案例！ [](https://modelcontextprotocol.io) [](#身份验证--范围) [](https://lawstronaut.com/products/lawstronaut-mcp) [](./LICENSE) [身份验证](#身份验证) . [设置](#设置) · [工具](#工具) </div> --- ## 这是什么？ Lawstronaut 是连接 AI 代理和软件到数百万个来自 150 多个司法管辖区的法律文档的基础设施层，结构化的法律数据，持续更新，准备好通过 MCP 使用。 ## 身份验证 生产环境 MCP 服务器： **`https://mcp.lawstronaut.com`** 传输： **MCP over Streamable HTTP** (`POST /`). 公共服务器卡（工具列表，无需身份验证）： `https://mcp.lawstronaut.com/.well-known/mcp/server-card.json` --- Lawstronaut MCP 支持 **Bearer token** 和 **OAuth 2.0** (`client_id` + `client_secret`)。需要付费订阅。 | 方法 | 最适合 | 工具列表 | 工具调用 | |--------|----------|--------------|------------| | Bearer token | CLI、脚本、没有 OAuth 的客户端 | 无需身份验证 | `Authorization: Bearer <token>` | | OAuth 2.0 | Cursor、VS Code、Claude、发布平台 | 无需身份验证 | OAuth 访问令牌（由客户端自动管理） | ### 获取 client ID、secret 或 bearer token 1. 访问 [lawstronaut.com](https://lawstronaut.com) 并购买订阅。 2. 登录到 [开发者门户](https://dev-portal.filerskeepersapi.co/)。 3. 从首页菜单打开 **MCP 服务器访问**。 4. 创建 **client ID** + **client secret**（OAuth）或 **bearer token**。 <img src="./assets/generate-client-secret.png" width="800" alt="lawstronaut logo" /> ### 选项 A — Bearer token 使用 **MCP 服务器访问** 中的 bearer token： ```http Authorization: Bearer <your-token> ``` 在环境中设置： ```bash export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here" ``` 示例配置：`cursor-mcp.json`、`vscode-mcp.json`、`claude-code.mcp.json`。 ### 选项 B — OAuth 2.0（client_id + client_secret） 在 [开发者门户](https://dev-portal.filerskeepersapi.co/) 中使用 **MCP 服务器访问** 创建的 `client_id` 和 `client_secret`。 | 端点 | URL | |----------|-----| | MCP 服务器 | `https://mcp.lawstronaut.com` | | 授权 | `https://mcp.lawstronaut.com/oauth/authorize` | | Token | `https://mcp.lawstronaut.com/oauth/token` | | OAuth 发现 | `https://mcp.lawstronaut.com/.well-known/oauth-authorization-server` | | 受保护资源 | `https://mcp.lawstronaut.com/.well-known/oauth-protected-resource` | **流程：** `response_type=code` → 重定向到 `code` → 在 `/oauth/token` 处使用 `grant_type=authorization_code`、`client_id`、`client_secret`、`code` 和 `redirect_uri` 交换。 仅支持 MCP OAuth 发现的客户端需要服务器 URL — 它们使用您注册的 `client_id` / `client_secret` 处理流程。 示例配置：`cursor-mcp-oauth.json`、`vscode-mcp-oauth.json`。 --- ## 设置 选择您的客户端，粘贴配置文件，并使用您的 lawstronaut 帐户进行身份验证。大多数客户端在首次使用 lawstronaut 工具的代理时，会打开一个浏览器窗口进行 OAuth。 ## Cursor **Bearer token** 1. 将 `cursor-mcp.json` 复制到 `.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局）。 2. 导出 `LAWSTRONAUT_MCP_BEARER_TOKEN`。 3. 重启 Cursor。如果连接失败，请检查 **输出 → MCP 日志**。 **OAuth** 1. 将 `cursor-mcp-oauth.json` 复制到 `.cursor/mcp.json`。 2. 当 Cursor 提示您时，完成 OAuth 登录（使用您注册的 `client_id` / `client_secret`）。 文档： [Cursor MCP](https://cursor.com/docs/context/mcp). --- ## VS Code（GitHub Copilot 代理 / MCP） **Bearer token** 1. 将 `vscode-mcp.json` 复制到 `.vscode/mcp.json`，或合并到您的 [用户 MCP 配置](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration)。 2. 运行 **MCP：列出服务器**，并在提示时输入您的 bearer token。 **OAuth** 1. 将 `vscode-mcp-oauth.json` 复制到 `.vscode/mcp.json`。 2. 在 VS Code 提示时进行登录。 文档： [MCP 配置参考](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration). --- ## Claude Code（CLI） **Bearer token — CLI** ```bash export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here" claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com \ --header "Authorization: Bearer $LAWSTRONAUT_MCP_BEARER_TOKEN" ``` **Bearer token — 项目文件** 将 `claude-code.mcp.json` 复制到项目根目录下的 `.mcp.json`。 **OAuth** 仅添加服务器 URL，并在提示时完成 OAuth： ```bash claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com ``` 文档： [将 Claude Code 连接到工具 via MCP](https://code.claude.com/docs/en/mcp). --- ## Claude Desktop（Anthropic 应用程序） Claude Desktop 面向 **stdio** MCP 服务器。对于此 HTTP 服务器，请使用 **Cursor**、**VS Code** 或 **Claude Code**，或任何支持远程 Streamable HTTP MCP 的主机。 前往 **自定义**，**连接器**，点击 "**+**"，**添加自定义连接器**，并填写对话框： <img src="./assets/claude-desktop.png" width="790" alt="claude" /> --- ## 其他主机（Continue、Zed、自定义代理等） 任何支持 **MCP Streamable HTTP** 的客户端都可以连接： - **URL:** `https://mcp.lawstronaut.com` - **Bearer:** `Authorization: Bearer <token>` - **OAuth:** 在 `/.well-known/oauth-authorization-server` 处使用发现，并使用您的 `client_id` / `client_secret` --- ## 工具 - **list_jurisdictions** - 列出 Lawstronaut 语料库中的所有司法管辖区（国家/州）- 调用第一个以获取其他工具的有效 ISO 代码 - **list_domains** - 列出法律领域，可选名称筛选和分页 - `domain`：按名称筛选领域（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - **list_subdomains** - 列出域名的子域 - 按名称筛选，结果分页 - `domain_id`：按域名 ID 筛选（字符串，必填） - `subdomain`：按名称筛选子域（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - **list_categories** - 列出子域名的法律类别 - 按名称筛选，结果分页 - `subdomain_id`：按子域名 ID 筛选（字符串，可选） - `category_name`：按名称筛选类别（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - **list_subcategories** - 列出类别的子类别 - 按名称筛选，结果分页 - `category_id`：按类别 ID 筛选（字符串，必填） - `subcategory_name`：按名称筛选子类别（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - **list_law_types** - 列出子类别的法律类型 - 按名称筛选，结果分页 - `subcategory_id`：按子类别 ID 筛选（字符串，必填） - `law_type`：按名称筛选法律类型（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - **list_portals** - 列出司法管辖区的法律门户 - 按名称、语言或标签筛选 - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `name`：按名称筛选门户（字符串，可选） - `tag`：按标签筛选（字符串，可选） - `lang`：按语言筛选（字符串，可选） - **list_authority_types** - 列出司法管辖区的权威类型 - 按门户或权威类型筛选 - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - `portal_name`：按门户名称筛选（字符串，可选） - `authority_type`：按权威类型筛选（字符串，可选） - **list_issuing_authorities** - 列出司法管辖区的颁发机构 - 按门户或机构名称筛选 - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - `portal_name`：按门户名称筛选（字符串，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - **list_documents** - 列出司法管辖区的法律文档 - 按标题、日期、门户、状态、标签等筛选 - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `portal`：按门户名称筛选（字符串，可选） - `version`：文档版本（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - `document_id`：文档 ID（字符串，可选） - `repealed`：按废除状态筛选（布尔值，可选） - `title`：按标题筛选（字符串，可选） - `section_title`：按章节标题筛选（字符串，可选） - `url`：按 URL 筛选（字符串，可选） - `status`：按状态筛选（字符串，可选） - `crawling_date`：按爬取日期筛选（字符串，可选） - `last_updated`：按最后更新日期筛选（字符串，可选） - `last_amendment`：按最后修订日期筛选（字符串，可选） - `publication_date`：按发布时间筛选（字符串，可选） - `expiration_date`：按过期日期筛选（字符串，可选） - `effective_date`：按生效日期筛选（字符串，可选） - `date_of_enactment`：按颁布日期筛选（字符串，可选） - `date_of_decision`：按判决日期筛选（字符串，可选） - `file_data_only`：仅返回文件相关数据（布尔值，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - `type_of_authority`：按权威类型筛选（字符串，可选） - `source_identifier`：按源标识符筛选（字符串，可选） - `source_secondary_identifier`：按次要源标识符筛选（字符串，可选） - `tag`：按标签筛选（字符串，可选） - `lang`：按语言筛选（字符串，可选） - **get_document_text** - 获取匹配司法管辖区和筛选条件的文档全文 - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `portal`：按门户名称筛选（字符串，可选） - `version`：文档版本（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - `document_id`：文档 ID（字符串，可选） - `repealed`：按废除状态筛选（布尔值，可选） - `title`：按标题筛选（字符串，可选） - `section_title`：按章节标题筛选（字符串，可选） - `url`：按 URL 筛选（字符串，可选） - `status`：按状态筛选（字符串，可选） - `crawling_date`：按爬取日期筛选（字符串，可选） - `last_updated`：按最后更新日期筛选（字符串，可选） - `last_amendment`：按最后修订日期筛选（字符串，可选） - `publication_date`：按发布时间筛选（字符串，可选） - `expiration_date`：按过期日期筛选（字符串，可选） - `effective_date`：按生效日期筛选（字符串，可选） - `date_of_enactment`：按颁布日期筛选（字符串，可选） - `date_of_decision`：按判决日期筛选（字符串，可选） - `file_data_only`：仅返回文件相关数据（布尔值，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - `type_of_authority`：按权威类型筛选（字符串，可选） - `source_identifier`：按源标识符筛选（字符串，可选） - `source_secondary_identifier`：按次要源标识符筛选（字符串，可选） - `tag`：按标签筛选（字符串，可选） - `lang`：按语言筛选（字符串，可选） - **get_markdown** - 获取匹配司法管辖区和筛选条件的文档主体为 markdown - `iso`：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填） - `portal`：按门户名称筛选（字符串，可选） - `version`：文档版本（字符串，可选） - `limit`：返回结果数（数字，可选） - `offset`：跳过结果数（数字，可选） - `document_id`：文档 ID（字符串，可选） - `repealed`：按废除状态筛选（布尔值，可选） - `title`：按标题筛选（字符串，可选） - `section_title`：按章节标题筛选（字符串，可选） - `url`：按 URL 筛选（字符串，可选） - `status`：按状态筛选（字符串，可选） - `crawling_date`：按爬取日期筛选（字符串，可选） - `last_updated`：按最后更新日期筛选（字符串，可选） - `last_amendment`：按最后修订日期筛选（字符串，可选） - `publication_date`：按发布时间筛选（字符串，可选） - `expiration_date`：按过期日期筛选（字符串，可选） - `effective_date`：按生效日期筛选（字符串，可选） - `date_of_enactment`：按颁布日期筛选（字符串，可选） - `date_of_decision`：按判决日期筛选（字符串，可选） - `file_data_only`：仅返回文件相关数据（布尔值，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - `type_of_authority`：按权威类型筛选（字符串，可选） - `source_identifier`：按源标识符筛选（字符串，可选） - `source_secondary_identifier`：按次要源标识符筛选（字符串，可选） - `tag`：按标签筛选（字符串，可选） - `lang`：按语言筛选（字符串，可选） - **get_source_url** - 获取原始源文件的时间限定签名 URL（PDF 等） - `document_id`：文档 ID（整数，必填） - **get_document_with_version** - 获取特定版本的具体文档，并带有完整元数据 - `document_id`：文档 ID（整数，必填） - `version`：版本（整数，必填） - **horizon_scan** - 扫描司法管辖区的最近法律变更 - 按主题、日期窗口和权威筛选 - `iso`：一个 ISO 代码，例如 "IE", "NL", "US", 等（字符串，必填） - `since`：扫描的日期窗口开始（字符串，可选） - `topic`：主题或关键词聚焦扫描（字符串，可选） - `date_field`：用于窗口的日期字段（字符串，可选） - `status`：按状态筛选（字符串，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - `type_of_authority`：按权威类型筛选（字符串，可选） - `include_repealed`: 包括废除的文档（布尔值，可选用的日期字段（字符串，可选） - `status`：按状态筛选（字符串，可选） - `issuing_authority`：按颁发机构筛选（字符串，可选） - `type_of_authority`：按权威类型筛选（字符串，可选） - `include_repealed`: 包括已废除的文档（布尔值，可选） - `max_per_jurisdiction`：每个司法管辖区的最大结果数（整数，可选） - **evidence_pull** - 获取文档的完整引用链 - 元数据、法律链接、源 URL 和正文文本 - `iso`：文档的司法管辖区 ISO 代码，例如 'IE', 'NL', 'US' 等（字符串，必填） - `document_id`：来自任何列表工具的 numeric document_id（整数，必填） - `include_text`：包括文档正文文本（布尔值，可选） - `include_source_url`：包括签名源 URL（布尔值，可选） - `text_format`：包含文本的格式（例如 markdown 或 plain）（字符串，可选） 所有工具均为只读。OAuth 令牌颁发时带有作用域 `mcp:tools:read`。工具列表公开；工具调用需要身份验证。