关于 Us Code
US Code 可按引文获取美国联邦法典文本,并支持查看法典标题列表和按主题搜索。适用于需要查阅法条的用户;引文查询无需密钥,搜索则需要 data.gov 密钥。
主要功能
- 01按引文获取法条文本
- 02列出 54 个法典标题及主题
- 03按主题搜索章节标题
- 04通过 GovInfo 链接解析引文
适用场景
- 01根据引文查找法条
- 02查看法典标题涵盖的主题
- 03查找与法律主题相关的标题
MCP 相关
提供 MCP 工具,用于获取条文、列出标题和搜索《美国法典》标题。引文查询和标题列表无需密钥;搜索需要 data.gov 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/us-code/mcpclaude mcp add --transport http pipeworx-io-us-code https://gateway.pipeworx.io/us-code/mcp{"mcpServers":{"pipeworx-io-us-code":{"type":"http","url":"https://gateway.pipeworx.io/us-code/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-us-code":{"type":"http","url":"https://gateway.pipeworx.io/us-code/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-us-code":{"type":"http","url":"https://gateway.pipeworx.io/us-code/mcp"}}}{"mcpServers":{"pipeworx-io-us-code":{"serverUrl":"https://gateway.pipeworx.io/us-code/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
美国法典——按引文查询联邦法规
美国法典全文。输入 18 和 1343,即可获取电信诈骗法规。
属于 Pipeworx 的一部分——这是一个连接 AI Agent 与 1684 多个实时数据源的 MCP 网关。
身份验证
检索无需身份验证。 usc_section 和 usc_titles 无需密钥。
usc_search 使用 GovInfo API,需要 data.gov 密钥——Pipeworx 提供了密钥,也可以传入 _apiKey。如果你已经有引文,usc_section 无需密钥,且路径更直接。
为什么已有 govinfo 可以访问数据,还需要这个工具包?
这是为了修复可达性,而非数据问题。一直以来,都可以通过通用的 govinfo 工具包获取美国法典——但当 Agent 询问“电信诈骗法规写了什么”时,它永远不会调用 search_packages({collections: 'USCODE'})。工具选择依赖对描述进行嵌入相似度匹配,因此通用容器无法与任何特定内容匹配。明确的入口胜过通用入口。
无需密钥的路径是 GovInfo 的引文链接服务:
/link/uscode/18/1343 → 302 → USCODE-2024-title18-partI-chap63-sec1343.htm
这比看起来更重要。文档 ID 中包含分编和章节信息——partI-chap63——但没人会从“18 U.S.C. § 1343”中知道这些信息。链接服务是从律师实际使用的引文跳转到文档本身的唯一途径。
工具
| 工具 | 是否需要密钥 | 返回内容 |
|---|---|---|
usc_section | 否 | 引文对应的完整法规文本 |
usc_titles | 否 | 54 篇及其主题 |
usc_search | 是 | 与主题匹配的条款标题 |
值得说明的注意事项
- 法典按年度版本发布,因此文本反映的是该版本发布时的内容,而非截至今天的内容。之后修订的法规不会体现在其中——对于任何时效性较强的内容,请查阅近期公法。
- 条款编号并非连续。 许多条款已废除或保留,因此缺少某个条款很正常,并非错误。
- 分款不是独立文档。 请求
1343(a)会返回 § 1343 的全部内容,并会在响应中明确说明,而不会悄悄扩大请求范围。 usc_search返回的是标题,而非条款编号。 GovInfo 的搜索不会公开条款编号,因此标题可以帮助识别法规,但不能直接作为引文。响应会说明这一点,而不会让人误以为可以直接引用。
相关工具包
court-listener— 解读这些法规的案例,包含完整判决文本ecfr、federal-register— 依据这些法规制定的规章congress— 修订这些法规的法案
数据来源
https://www.govinfo.gov/ — 美国政府出版局提供的美国法典。属于公有领域。
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"us-code": {
"url": "https://gateway.pipeworx.io/us-code/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/us-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 都会访问同一个网关和相同的 1684 多个数据源。唯一的区别在于,哪些工具包的工具会被直接列出;无论使用哪个 URL,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/usc_section \
-H 'Content-Type: application/json' \
-d '{"title":"18","section":"1343"}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/usc_section。查找工具:使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行,无需 Pipeworx 账户,也无需经过网关:
{
"mcpServers": {
"us-code": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-us-code"]
}
}
}
或者直接运行,确认它可以启动:
npx -y @pipeworx/mcp-us-code
它通过 stdin/stdout 使用 MCP,并响应 initialize/tools/list/tools/call,仅提供此软件包的工具,不包含上述网关连接所添加的共享元工具。相同的源代码,相同的工具,无需 ask_pipeworx 路由。
使用 ask_pipeworx
你可以用通俗的英语提问,而不是直接调用工具——这既适用于上面的软件包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Us Code data" })
网关会选择合适的工具并自动填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。