关于 American Samoa Code
American Samoa Code 是面向法律研究人员等用户的 MCP 服务,用于查阅《美属萨摩亚注释法典》。它无需凭证即可按引文查找法规、搜索主题和关键词,并列出法典标题。
主要功能
- 01按引文获取法规全文
- 02搜索主题和关键词
- 03列出已发布的法典标题
- 04返回修订历史和判例注释
适用场景
- 01查阅指定引文对应的法规
- 02按法律主题查找相关条文
- 03确定主题对应的法典标题
MCP 相关
通过 Pipeworx 或独立 stdio 服务向 MCP 客户端提供法规查询、搜索和标题列表工具。网关连接还包含 Pipeworx 共享元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/american-samoa-code/mcpclaude mcp add --transport http pipeworx-io-american-samoa-code https://gateway.pipeworx.io/american-samoa-code/mcp{"mcpServers":{"pipeworx-io-american-samoa-code":{"type":"http","url":"https://gateway.pipeworx.io/american-samoa-code/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-american-samoa-code":{"type":"http","url":"https://gateway.pipeworx.io/american-samoa-code/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-american-samoa-code":{"type":"http","url":"https://gateway.pipeworx.io/american-samoa-code/mcp"}}}{"mcpServers":{"pipeworx-io-american-samoa-code":{"serverUrl":"https://gateway.pipeworx.io/american-samoa-code/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
44| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | question 的别名。 |
| ask | string | 否 | question 的别名。 |
| text | string | 否 | question 的别名。 |
| input | string | 否 | question 的别名。 |
| packs | array | 否 | 可选。将路由限制为这些包的 slug(例如 ["sec-form-d","sec-13f"]),路由器随后只会从这些包中的工具进行选择。省略则使用默认的完整目录路由。Slug 可从 list_packs / search_packs / https://pipeworx.io/directory 获取;未列出或未知的 slug 会被忽略,并在 _meta.pack_scope.ignored 中列出。如果没有任何 slug 能匹配问题,则会在整个目录中路由,并设置 _meta.pack_scope.full_catalog:true(绝不会返回空答案)。 |
| query | string | 否 | question 的别名。 |
| prompt | string | 否 | question 的别名。 |
| message | string | 否 | question 的别名。 |
| question | string | 是 | 用自然语言表达的问题或请求。支持 query、q、prompt、text、input、ask、message 作为别名。 |
详细介绍
@pipeworx/american-samoa-code
美属萨摩亚注释法典(A.S.C.A.)——按引文查找章节,并按主题/关键词搜索。无需密钥。
属于 Pipeworx——一个将 AI Agent 连接到 1872+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成,与上游提供方无关联、未获其认可,也非由其发布。
工具
as_statute(citation)— 按引文获取 A.S.C.A. 章节全文 (“46.3502”是一级谋杀;“1.0201”是适用于美属萨摩亚的法律)。返回法条文本、所属章、“History:” 修订记录,以及 asbar.org 为该章节发布的任何“Case Notes:”(判例法注释)。as_search(query, limit?)— 通过 asbar.org 自带的站内搜索按主题/关键词搜索,筛选注释法典章节结果,并返回匹配的引文、标题和 URL。as_titles()— 法典已发布的全部 38 个标题及其官方名称,用于将主题映射到正确的标题编号。
身份验证
无需密钥。
填补华盛顿特区和属地的空白
在完成 50 个州的法典整理后,Bruce 于 2026-10-09 提出覆盖华盛顿特区以及 5 个有人居住的美国属地(#2881、#2883-#2885):华盛顿特区、波多黎各、关岛、美属维尔京群岛、美属萨摩亚和北马里亚纳群岛当时都没有法典包(dc-dmv 仅提供机动车记录)。美属萨摩亚是这 6 个地区中首个上线的。
来源和单跳架构
美属萨摩亚律师协会(asbar.org)以每个章节一个 WordPress 文章的形式发布完整的注释法典,无需密钥或注册——以上所有工具均已通过实时验证。与俄克拉荷马州的 OSCN 或北达科他州的 ndlegis.gov 不同,这里没有可用于解析引文的分标题索引页;所有章节都可直接通过 /code-annotated/TITLE-SECTION-slug/ 访问,而完整的引文 -> URL 映射来自 asbar.org 为 code_annotated 文章类型提供的 Yoast SEO XML 站点地图——已确认这是唯一途径,因为该文章类型没有 REST 路由(实时访问 /wp-json/wp/v2/code_annotated 会返回 404)。因此,as_statute 每次调用只需进行一次实时抓取(即章节页面本身);引文 -> URL 的解析使用内置查找表,无需第二跳。
内置索引
src/as-index-data.ts 将引文 -> URL 映射(以及从 asbar.org 的“Code Annotated by Title and Chapter”页面获取的 38 个官方标题名称)写入内置数据,数据来源是 4 个 code_annotated-sitemap{,2,3,4}.xml 分片——共 3,597 个 URL,解决少数冲突后得到 3,572 条引文(见下文)。索引通过 KV 使用,不包含在网关包中(workers/gateway/src/pack-baked-indexes.json,fleet #2754)——网关会在首次调用此包时将其作为 args._bakedIndex 注入。
刷新流程。 Fono 修订法典且 asbar.org 添加章节时(以他们的安排为准,而非我们)重新运行:
node mcps/american-samoa-code/scripts/bake-index.mjs > mcps/american-samoa-code/src/as-index-data.ts
如果站点地图条目数或标题数远低于 asbar.org 当前提供的数量,流程会明确报错——这两种情况都意味着网站布局发生了变化。
实时发现的两种冲突类型(不是解析错误,而是 asbar.org 自身的数据问题)
3,578 个有效章节 URL 中有 6 个引文冲突。我们已通过抓取每个页面并核对其标题,确认了所有冲突:
- WordPress 重复发布(6 个冲突中的 2 个):同一页面被发布了两次,第二次使用 WordPress 自带的
-2slug 冲突后缀(例如6-0210-entitlement-to-vote和6-0210-entitlement-to-vote-2,法条文本逐字相同)。生成器会将其合并为规范 URL(不带后缀)。 - 真实引文冲突(6 个冲突中的 4 个):两个不同的章节使用了同一引文——例如,“4.1402 Definitions.” 和 “4.1402 Individualized service plan–Case management.” 都使用引文 4.1402。
as_statute会将两者都作为candidates返回,并标记ambiguous: true,而不是静默地选取其中一个。
一个不规则 slug
1.0101(“Citation.”)发布在 /code-annotated/10101-citation/ —
标题与章节之间没有连字符,与其他所有 URL 都不同。该地址在生成器中作为唯一例外硬编码。
带子编号的章节
3,597 个 slug 中有 20 个包含第三段数字,例如
/code-annotated/4-1307-1-limitation-of-liability/,这段数字是原文引文
4.1307.1(已由该页面本身的标题确认),并非 slug 描述性尾部的一部分。as_statute 接受带有这段第三段数字的引文。
已知的上游内容错误,保持原样
至少有一个章节的标题与正文不符:标题为
“4.1307.1 Limitation of liability.” 的页面(已确认当前线上版本)实际提供的正文与另一个关于部门协议的章节相同。这是 asbar.org 自身发布的内容,并非我们这边的解析错误 — as_statute 返回的内容与源站完全一致,并使用该章节自己的 URL,因此调用方可以核实。
边缘探测
已于 2026-10-09 在生产账户上,通过临时的 pw-yeva-edgeprobe-americansamoacode
wrangler dev --remote Worker 确认了此工具包使用的全部三种 URL 格式 — 从 Worker 的出口访问 asbar.org 时,没有遇到 Cloudflare Turnstile 或其他质询;与 oscn.net
(mcps/oklahoma-code)不同:
| URL 格式 | 状态 | 长度 | 起始字节 |
|---|---|---|---|
/code-annotated/46-3502-murder-in-the-1st-degree/ | 200 | 63,080 B | 正常的 HTML doctype + UTF-8 charset meta 标签,与笔记本电脑自身的 curl 结果一致 |
/search/domestic%20violence/feed/rss2/ | 200 | 205,246 B | 正常的 RSS 2.0 XML 声明,包含 channel/title 元素 |
/code_annotated-sitemap.xml | 200 | 148,922 B | 正常的 sitemap XML 声明,包含 urlset 元素 |
这三种响应的 server: cloudflare 均存在,且 content-type 与实际资源类型(HTML / RSS+XML / XML)相符 — 响应结构与笔记本电脑自身的 curl 结果逐字节一致,证实 asbar.org 不会像 oscn.net 那样单独拦截来自 Worker 的请求。
数据来源
https://asbar.org/code_annotated-sitemap{,2,3,4}.xml— 章节 URL 的完整列表(仅预先打包一次,不会在每次调用时获取)。https://asbar.org/legal-resources/code-annotated/code-annotated-by-title-and-chapter/— 38 个官方标题名称(仅预先打包一次)。https://asbar.org/code-annotated/TITLE-SECTION-slug/— 某一章节的全文、章、历史记录和案例注释。as_statute。https://asbar.org/search/<query>/feed/rss2/?paged=N— 律师协会自有网站的搜索功能,以 RSS 格式提供(分页,每页 10 条结果)。as_search。
所有数据均无需密钥,且由服务器渲染为 HTML/XML — 无需登录、无需 JS,开发期间也未观察到速率限制。
快速开始
添加到 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"american-samoa-code": {
"url": "https://gateway.pipeworx.io/american-samoa-code/mcp"
}
}
}
此端点实际提供的内容
tools/list 在 https://gateway.pipeworx.io/american-samoa-code/mcp 返回上表中的工具,以及 Pipeworx 共享元工具 — ask_pipeworx、
discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此,你看到的工具数量会多于表格中的数量:单个工具包端点目前会列出大约 30 个共享工具,以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围,并且是当天情况的权威答案。
这是有意设计的,并非意外进行多路复用。元工具可以让限定范围的连接回答本工具包未涵盖的问题 — 通过 ask_pipeworx 跨整个目录进行路由 — 而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点;如果额外的架构定义所占用的上下文超过了路由带来的价值,请连接一次完整网关,而不是连接多个工具包端点。
或者连接完整的 Pipeworx 网关,直接列出每个工具包的所有工具,而不仅仅是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出哪个工具包的工具;ask_pipeworx 可从任一端点访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/as_statute \
-H 'Content-Type: application/json' \
-d '{"citation":"46.3502"}'
首次调用无需账户。查看任意工具:GET https://gateway.pipeworx.io/v1/tools/as_statute。查找工具:使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户,也无需经由网关往返:
{
"mcpServers": {
"american-samoa-code": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-american-samoa-code"]
}
}
}
或者直接运行,确认它能够启动:
npx -y @pipeworx/mcp-american-samoa-code
它通过 stdin/stdout 使用 MCP 通信,并为仅此工具包的工具响应 initialize/tools/list/tools/call — 不包含上述网关连接提供的任何共享元工具。来源相同,工具相同,但没有 ask_pipeworx 路由。
使用 ask_pipeworx
你也可以用通俗英语提问,而不直接调用工具 — 此方式既适用于上面的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about American Samoa Code data" })
网关会选择合适的工具,并自动填入参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。