Kentucky Code

@pipeworx/kentucky-code

《肯塔基州修订法规》（KRS）——按引文和主题搜索州法规，并提供立法／修订历史。无需密钥。

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

工具

• ky_statute(citation) — 按引文查询 KRS 条文的现行文本 （"507.020"、"KRS 383.580"、"§ 507.020"）。返回标题、完整法规 文本、effective_date 和 history 行（制定及修订该条文的法案）。网上 没有任何地方提供修订前的文本；historical_versions 会明确说明这一点， 而不是悄悄省略。
• ky_search(query, limit?) — 对法规正文进行全文主题搜索，而不仅仅搜索标题 （"landlord" 会查到 KRS 383.580「Security deposits」，其标题不包含这两个 词）。返回匹配的引文和标题；传入引文即可用 ky_statute 获取完整文本。

身份验证

无需密钥。调用双方都无需注册或密钥。

数据源

• https://apps.legislature.ky.gov/LRCSearch/Home/getStatuteJSON — 立法研究委员会 自有的引文／主题搜索接口。通过 GET 请求，使用 searchPhrase、 statuteRange=true&startRange=1&endRange=999，并在精确引文查询时设置 searchStatuteNumber=true。需要新的 RequestVerificationToken 请求头，该令牌 从 https://apps.legislature.ky.gov/lrcsearch 上的内嵌 <script> 中读取——它 不与 Cookie 绑定（已确认：搜索页面不会设置 Cookie），因此每次调用的完整流程 是：先 GET 获取令牌，再向 API 发出 GET 请求。无需登录。
• https://apps.legislature.ky.gov/law/statutes/statute.aspx?id= — 匹配条文的完整 文本，以各条文独立的 PDF 形式提供（content-disposition: inline;FileName="KRS507_020(K).pdf"）。 网站上没有任何 HTML 页面提供法规正文；章节索引页面仅列出标题。文本通过 shared/src/pdf-text.ts 中新增的 extractPdfText 辅助函数提取（该文件说明了它 能处理和不能处理的内容）——在此扩展包之前，这个仓库没有 PDF 文本提取功能。

不透明 ID 陷阱，以及为何这不是两跳解析器。 8 月的州法调查 （docs/state-law-probe.md）指出，肯塔基州法规 URL 使用不透明数据库 ID，无法 从引文推导出对应关系——佛蒙特州和康涅狄格州采用两跳请求、通过章节索引解析时， 也遇到了同样的情况。肯塔基州的章节索引页面（chapter.aspx?id=）确实包含这种 对应关系（已确认：第 507 章的索引在其 ID 旁列出「.020 Murder.」），因此两跳 方式可行；但更简单的单跳方式也可行，而且本扩展包采用的正是这种方式：立法研究 委员会自己的搜索 API 可将引文直接解析为 ID，因为它会对整个 KRS 进行真正的全文 搜索，而不是搜索标题／条目索引（已通过实时验证：搜索「landlord」会查到 KRS 383.580，其标题仅为「Security deposits」。）

四种能力，三种可用。 引文查询和主题搜索使用的是同一个搜索端点，只是标记 不同；修订／历史信息来自法规自身的 History: 行，并从提取出的 PDF 文本中解析。 第四种能力——某条文在特定修订之前的文本——网上没有任何地方发布：已废止的 ID 会重定向至「Invalid Statute」页面，并提示读者发邮件向法规修订官索取。此扩展包 会将其报告为 historical_versions，而不是默默留空。

分部／章节标题行。 搜索 API 的 Type 字段中，真实法规条文为 "K"，分部／ 章节标题为 "D"（没有法规正文——ky_statute 会返回 not_a_section，而不会 为其获取 PDF），已废止条文为 "R"（仍会返回文本；type_label 会说明其类型）。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/kentucky-code/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 都连接到同一个网关和相同的 1882+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ky_statute \
  -H 'Content-Type: application/json' \
  -d '{"citation":"507.020"}'

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

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

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

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

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

npx -y @pipeworx/mcp-kentucky-code

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。相同的源代码，相同的工具，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Kentucky Code data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT