es-eli-mcp

es-eli-mcp

安装（一个命令）

作为 Claude 插件使用（Claude Code 或桌面应用，需要 uv）； 关于它会发送和存储哪些内容，请参阅 plugin/README.md：

/plugin marketplace add matematicsolutions/es-eli-mcp
/plugin install es-eli-mcp@es-eli-mcp

已发布到 PyPI 和 MCP Registry（io.github.matematicsolutions/es-eli-mcp）。无需克隆即可运行：

uvx es-eli-mcp

配置 MCP 客户端（stdio）：

{ "mcpServers": { "es-eli-mcp": { "command": "uvx", "args": ["es-eli-mcp"] } } }

在启用了 Smart App Control 的 Windows 11 上使用

Smart App Control 会拦截未签名的可执行文件，其中包括 uvx.exe、pip.exe 以及 pip 在安装时生成的 es-eli-mcp.exe 启动器。python.org 安装程序提供的 python.exe 和 py.exe 由 Python Software Foundation 签名，因此通过解释器运行模块即可：

python -m pip install es-eli-mcp
python -m es_eli_mcp

pip.exe 也会因同样的原因被拦截，因此请使用 python -m pip 安装，而不要运行 pip install。如果 python 不在 PATH 中，请使用 Windows 启动器：py -3 -m es_eli_mcp。

{ "mcpServers": { "es-eli-mcp": { "command": "python", "args": ["-m", "es_eli_mcp"] } } }

不要为了绕过此问题而关闭 Smart App Control——重新启用它需要重新安装 Windows。

从源代码构建：请参阅安装。

一个面向五个西班牙开放数据源的 MCP 服务：

1. BOE（Boletin Oficial del Estado）开放数据 API——合并版立法。提供 BOE 编号 或官方公报中的日期，即可返回元数据、结构和完整合并文本，并附带可验证的 ELI 标识符和西班牙语引文。
2. Tribunal Constitucional（Sistema HJ / hj.tribunalconstitucional.es）——西班牙 宪法法院判例（Sentencias / Autos / Declaraciones）。提供内部 裁决编号，或引文编号和年份（例如“STC 31/2010”），即可返回完整裁决，并附带 ECLI 和西班牙语法律学术引文。
3. DGT（Direccion General de Tributos，petete.tributos.hacienda.gob.es）——具有约束力的税务 裁定：约 69,500 条 consultas vinculantes + 约 19,700 条 consultas generales（实时计数， 截至 2026-07-08）。支持全文/日期搜索，并可通过 NUM-CONSULTA（例如 “V0001-25”）获取完整裁定文本。
4. TEAC（Tribunales Economico-Administrativos，DYCTEA）——约 6,500 条 doctrina criterios，内嵌完整裁决文本；可按 RG 索赔编号片段和/或日期范围搜索。
5. AEPD（Agencia Espanola de Proteccion de Datos）——约 46,800 条数据保护裁决， 支持 Solr 全文搜索，并为每个 expediente 提供经过验证的 PDF 永久链接（例如 “PS-00615-2025”）。

这是 MateMatic eu-legal-mcp 产品线的一部分——继 PL、DE 和 AT 之后。采用相同的引文 契约模式，涵盖五个西班牙数据源。

仅 DGT 和 AEPD 支持自由文本搜索。 BOE 开放数据关键词搜索端点 （/legislacion-consolidada）目前会返回服务器端错误；Tribunal Constitucional 网站仅支持结构化搜索（引文编号和年份、ECLI、magistrado、 materia）；DYCTEA 接受看似文本的参数，但会静默忽略这些参数（已实时验证）。 可通过 es_browse_gazette（按日期）或已知的 BOE 编号 / ELI 查找 BOE 文档；通过 es_search_constitutional 查找 TC 裁决；通过 RG 片段或日期查找 TEAC criterios。每个响应 都带有 dataset_note。

许可。 两个数据源都是以西班牙 PSI （公共部门信息）开放数据形式发布的官方公共信息；重用须遵守相应的重用 条件。此连接器会注明出处并附带 source_url，转发这些公共内容。

工具

工具	功能
es_browse_gazette	列出某个日期（YYYYMMDD）在 BOE 上发布的文档——用于发现。
es_get_act	获取 BOE ID 的元数据（eli_uri、官方 titulo、来源）。
es_get_index	获取整编法律的分块索引（条款、标题）。
es_get_text	获取整编文本（XML），可获取全文或指定分块。
es_get_constitutional_ruling	根据内部裁决 ID 获取 Tribunal Constitucional 裁决。
es_search_constitutional	将引文（numero+anno，例如 31/2010）解析为完整的 TC 裁决。
es_search_tax_rulings	对 DGT consultas（约束性或一般性）进行全文／日期搜索。
es_get_tax_ruling	根据 NUM-CONSULTA 获取完整的 DGT 裁决（事实、问题、normativa、答复）。
es_search_teac_doctrine	按 RG 字段和／或裁决日期范围搜索 TEAC criterios。
es_get_teac_criterio	根据 DYCTEA ID 获取完整的 TEAC criterio 和裁决文本。
es_search_aepd_resolutions	对 AEPD 裁决进行全文／日期搜索。
es_get_aepd_resolution	根据 expediente 获取 AEPD 裁决和经过验证的全文 PDF 永久链接。
es_coverage	说明此连接器涵盖的内容、各类别的采集时间，以及明确说明未涵盖的内容。每项缺口都附有备用方案。

每个 BOE 响应都包含以下约定字段：eli_uri（完整的 ELI URL，例如 https://www.boe.es/eli/es/lo/2018/12/05/3）、human_readable_citation（官方 titulo）和 source_url。

每个 Tribunal Constitucional 响应都包含：ecli（例如 ECLI:ES:TC:2010:31——TC 判例 没有 ELI，ELI 仅适用于法律）、human_readable_citation（西班牙法律文献惯例， 例如 “STC 31/2010, de 28 de junio”）和 source_url。

安装

cd es-eli-mcp
pip install -e .

配置（Claude Code／任何 MCP 客户端）

{
  "mcpServers": {
    "es-eli-mcp": { "command": "es-eli-mcp" }
  }
}

环境变量：

• ES_ELI_BASE_URL - 默认值为 https://www.boe.es/datosabiertos/api
• ES_ELI_TC_BASE_URL - 默认值为 https://hj.tribunalconstitucional.es
• ES_ELI_DGT_BASE_URL - 默认值为 https://petete.tributos.hacienda.gob.es
• ES_ELI_TEAC_BASE_URL - 默认值为 https://serviciostelematicosext.hacienda.gob.es/TEAC/DYCTEA
• ES_ELI_AEPD_BASE_URL - 默认值为 https://www.aepd.es
• ES_ELI_CACHE_DIR - 默认值为 ~/.matematic/cache/es-eli
• ES_ELI_AUDIT_DIR - 默认值为 ~/.matematic/audit

无需 API 密钥。五个来源均无需密钥。

治理

• 仅限公共数据 - 仅以只读方式访问五个官方来源；客户端数据不会离开本机。
• 审计日志 - 每次工具调用都会向 ~/.matematic/audit/es-eli-mcp.jsonl 追加一行 JSON。
• 网络 - 服务会连接官方 *.boe.es／*.tribunalconstitucional.es／ *.hacienda.gob.es／*.aepd.es 主机以及本地文件系统。首次使用时，它还会从此仓库的 GitHub Releases 获取一个小型配置文件（es-runtime.json.gz，其中包含更新后的来源地址）。该请求不包含查询内容；我们唯一能看到的使用情况信号，是 GitHub 对该文件的下载计数。设置 ES_ELI_RUNTIME_URL="" 可关闭此功能；Claude 插件默认已关闭此功能。无 LLM 提供商，也无其他遥测数据。
• 可验证的引文 - 每个响应都可通过 source_url 独立核验。

请参阅 CONSTITUTION.md 和 DISCOVERY.md。

测试

pip install -e ".[dev]"
pytest tests/ --ignore=tests/test_smoke.py -v   # offline (fixtures)
pytest tests/test_smoke.py -v                   # hits live BOE + TC + DGT + TEAC + AEPD

许可证

Apache-2.0。© Matematic Solutions / Wieslaw Mazur。