Boe Legislacion

@pipeworx/boe-legislacion

西班牙现行整合法律——每部西班牙法律和皇家法令都已纳入所有修订并保持最新，同时提供国家官方公报每日目录。数据来自西班牙国家官方公报国家机构（Agencia Estatal Boletín Oficial del Estado，BOE）。

属于 Pipeworx 的一部分——连接 AI Agent 与 1875+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联，未经其认可，也非其发布。

工具

• boe_search_law(query, ambito?, limit?, offset?) — 按标题中的词语搜索整合法律 （例如“《民法典》”“水平产权法”）。返回匹配法律及其 BOE ID、法律级别、 发布部门、适用范围（国家／地区）、关键日期，以及各法律的 BOE 官方页面 URL。将返回的 ID 传给 boe_law。
• boe_law(id, article?) — 按 BOE ID 获取一部整合法律。不带 article 时：返回元数据（级别、部门、整合状态、日期）、主题标签、备注， 以及法律条款／章节（“bloques”）目录；最多返回 200 项，大型法典会标记为 truncated。带 article 时（目录中的区块 ID，例如第 1 条对应的 "a1"）： 返回该条文历经的所有历史版本的正文，各版本均标注日期，并标记当前版本。
• boe_daily_summary(date) — 获取某日 BOE 期刊的目录：当天发布的所有法规和公告， 按栏目和发布部门分组，并附上每项内容的 BOE ID 和标题。BOE 并非每天出版 （周日不出版，部分节假日也不出版）；这些日期会返回 found: false，而不是 空列表。

身份验证

无需密钥。上游开放数据 API 无需注册、密钥或点击确认条款；任何发送 Accept: application/json 的请求都可以访问。

数据来源

• 西班牙国家官方公报国家机构（Agencia Estatal Boletín Oficial del Estado，BOE），《现行整合法律》——西班牙国家和地区法律的整合文本数据库，并随所有修订保持更新。
• 西班牙国家官方公报国家机构（Agencia Estatal Boletín Oficial del Estado，BOE），《目录》——国家官方公报的每日目录。

备注

• 只有状态码为 200 时，Accept 标头才会生效。 发生任何错误（400/404/500）时， 上游都会完全忽略 Accept: application/json，始终返回固定的小型 XML 封装 （状态码 + 文本，数据为空），不受请求内容影响。此处的每次调用都会先将响应正文 读取为文本，只有在内容看起来像 JSON 时才解析为 JSON，因此错误消息不会因 res.json() 解析失败而丢失。
• 空结果的格式并不统一。 搜索无匹配项时会返回状态码 200，且 "data": ""—— 空字符串，而不是 [] 或 {}；有结果的列表和单条记录查询则都会以数组形式 返回（"data": [...]，即使只有一条记录）。boe_search_law 和 boe_law 会 对这些格式进行规范化；确实没有结果时会以普通文字返回 found: false，不会用 空数组伪装成成功。
• 条文／章节正文没有 JSON 格式。 只有目录（texto/indice）可用 JSON 获取； 区块正文仅提供 XML。Workers 运行时没有 XML 解析器，因此 boe_law 带有 article 时，会根据 BOE 固定的 XML 结构（一个区块、一个或多个版本、每个版本 一个段落）使用专门的正则表达式提取段落。这对真实法律文本可靠，但并非通用 XML 解析器。
• 大型法典的体量非常庞大。 仅《民法典》的目录就有 2,444 个区块。 boe_law 不带 article 时会限制内联返回的内容，并报告 articles.total / articles.truncated，不会一次性返回全部内容——请使用 article 逐个读取区块。
• 上游不会报告搜索匹配项的总数——通过 limit / offset 分页，并由 shown 告知本次调用返回的条目数。

快速开始

添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "boe-legislacion": {
      "url": "https://gateway.pipeworx.io/boe-legislacion/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/boe-legislacion/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关全局工具集中的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是当天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答本工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——而无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过了路由功能带来的价值，不如只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1875+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/boe_search_law \
  -H 'Content-Type: application/json' \
  -d '{"query":"Código Civil","limit":5}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/boe_search_law。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "boe-legislacion": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-boe-legislacion"]
    }
  }
}

或者直接运行，确认它能启动：

npx -y @pipeworx/mcp-boe-legislacion

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上述网关连接所添加的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用日常语言提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Boe Legislacion data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT