内容
# LexAPI MCP
[模型上下文协议](https://modelcontextprotocol.io) 服务器，用于 [LexAPI](https://lex-api.com) — 从 Claude、Cursor 和其他支持 MCP 的客户端查询欧盟法律、欧盟案例法和引用图谱。
安装一次，获取 API 密钥，然后询问您的 AI 助手： *"总结GDPR第17条"* 或 *"哪些法规修改了指令95/46/EC?"* — 模型直接调用 LexAPI。
## 安装
您需要一个 LexAPI API 密钥。在 [lex-api.com/dashboard](https://lex-api.com/dashboard) 上免费创建一个（每天50次调用）。
### Claude 桌面版
添加到 `claude_desktop_config.json`（位置：`~/Library/Application Support/Claude/claude_desktop_config.json` 在 macOS 上）：
```json
{
"mcpServers": {
"lexapi": {
"command": "npx",
"args": ["-y", "@lexapi/mcp"],
"env": {
"LEXAPI_API_KEY": "lex_..."
}
}
}
}
```
重启 Claude 桌面版。
### Claude 代码
```bash
claude mcp add lexapi --env LEXAPI_API_KEY=lex_... -- npx -y @lexapi/mcp
```
### Cursor / 其他 MCP 客户端
任何支持stdio MCP服务器的客户端都可以运行此命令。该命令是 `npx -y @lexapi/mcp`，环境变量中带有 `LEXAPI_API_KEY`。
## 工具
| 工具 | 功能 |
|---|---|
| `lex_search` | 结构化的欧盟法律搜索（文本、日期、文件类型、作者、语言）。 |
| `lex_get_document` | 通过 CELEX 获取完整的解析文档 — 元数据 + 文章、章节、表格、附件。 |
| `lex_get_metadata` | 仅获取元数据（比完整内容更快）。 |
| `lex_get_document_by_url` | 通过欧盟法律 URL 获取（从浏览器复制）。 |
| `lex_recent_documents` | 最近的官方期刊出版物（默认为 7 天）。 |
| `lex_cited_by` | 引用此 CELEX 的文档（入站、有类型边的）。 |
| `lex_cites` | 此 CELEX 引用的文档（出站、有类型边的）。 |
| `lex_citation_network` | 单次调用双向。 |
| `lex_semantic_case_law` | 欧盟案例法的嵌入式搜索（付费计划）。 |
| `lex_semantic_legislation` | 欧盟立法的嵌入式搜索（付费计划）。 |
## 配置
| 环境变量 | 默认值 | 用途 |
|---|---|---|
| `LEXAPI_API_KEY` | *(必填)* | 您的 API 密钥。在 [lex-api.com/dashboard](https://lex-api.com/dashboard) 上获取。 |
| `LEXAPI_BASE_URL` | `https://lex-api.com/api/v1` | 自托管或测试环境的覆盖。 |
## 故障排除
**`LEXAPI_API_KEY 未设置`** — 环境变量未到达子进程。请在 MCP 客户端配置中检查 `env` 块。
**`LexAPI 错误（401 invalid_api_key）`** — 密钥错误或已撤销。在仪表板上生成一个新的。
**`LexAPI 错误（429 …）`** — 您已达到每日配额或每分钟速率限制。服务器会自动重试一次；如果您在工具输出中看到此错误，则已超出配额。升级您的计划或等待重置。
**`LexAPI 错误（403 …） 在语义工具上`** — 语义搜索需要付费计划。免费层为这些端点返回 403。
## 本地开发
```bash
git clone https://github.com/lexapi/lexapi-mcp.git
cd lexapi-mcp
npm install
npm run build
LEXAPI_API_KEY=lex_xxx node dist/index.js
```
## License
MIT
