referencesource.org

io.github.joelp22-maker由 GitHub 账号 joelp22-maker 发布v1.2.0更新于 Oct 24, 2026

Verified reference data; each record carries its source URL and quote. verify_quote checks claims.

已验证Streamable HTTP可网页运行知识与记忆数据与分析

概览

AI 生成的概览

检索 referencesource.org 的已核实参考数据集,并用带来源网址和原文引用的记录核对所声称的数值。

可以做什么
  • 列出已发布数据集及其记录数、覆盖范围和最后核实日期
  • 按关键词、名称、化学品或证书编号在数据集中搜索记录,并返回来源网址与原文引用
  • 按 id 获取单条记录及完整出处
  • 核对某个声称的数值,返回匹配记录、匹配引用、不一致或未找到的判定
  • 仅限 Muse 连接器:领取队列中的下一个任务、提交任务结果、读取每日简报、向主管留言
适用场景
当回答依赖精确的参考数值(如监管阈值、贷款上限、认证状态或版本兼容性),并且希望每个数值都能追溯到引用来源,或需要核对手中已有的说法时适用。
运行要求
可使用远程 streamable-HTTP 端点,或通过 npx 运行 npm 包,后者需要 Node 18 及以上。数据类工具无需账号、密钥或环境变量;Muse 连接器工具需要 bearer token。
安装前请注意
Muse 连接器工具需要 bearer token,且会写入数据:提交任务结果和向主管收件箱发送消息。结果有长度限制,较长内容需放入指定文件。核对结果只反映已发布记录的表述,未找到仅表示该数据集中没有,并不代表为假。

安装

在 SourceWeft 中

  1. 打开 控制台中的 referencesource.org,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.joelp22-maker%2Freferencesource/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "referencesource-org": {
      "type": "http",
      "url": "https://referencesource.org/mcp"
    }
  }
}

README

referencesource-mcp

[referencesource.org MCP connector]

MCP server for referencesource.org — small, verified reference datasets where every record carries its source URL and a verbatim quote from that page, so any value an assistant gives you can be checked, not just believed.

285 datasets, 110,000+ records: regulatory thresholds and deadlines, version compatibility, standards supersessions, certification registers, inspection requirements, and more. Each dataset states its coverage and its last-verified date.

Tools

toolwhat it does
list_datasetsevery dataset with record counts and descriptions
search_recordssearch within a dataset; each hit returns the value plus its source URL and verbatim source quote
get_recordone record by id, full provenance included
verify_quotegive it a dataset slug and a value you already hold (record id and field optional) — it checks that claim against our published records and says whether it matches

verify_quote is the unusual one: assistants invent plausible-but-wrong values roughly 19% of the time in our own measurements, and this is the check. Four verdicts come back:

verdictwhat it means
matches_recordthe claim equals the stored value; the match type is named (exact, case-insensitive, normalised)
matches_quotenot a stored value, but it does appear in the record's source quote
differsthe record holds a different value — both are returned, with the source
not_foundno record in that dataset carries it

Where a record is found, the answer carries the stored value, the record URL, the source URL and the verbatim quote, so the claim can be traced upstream — plus an attestation saying plainly that the verdict is about what our source states, not about what is true in the world. Asking whether the 2026 conforming loan limit for Autauga County, Alabama is $806,500 returns differs, stored value $832,750, quoting the FHFA row it came from.

Scope, stated so nobody overclaims: these tools search referencesource.org's own published records. They do not fetch arbitrary URLs and cannot check a claim against a page we have not harvested. not_found means "not in this dataset", never "false".

Setup

Claude Desktop — add to claude_desktop_config.json:

json
{  "mcpServers": {    "referencesource": {      "command": "npx",      "args": ["-y", "referencesource-mcp"]    }  }}

Cursor / other stdio MCP clients — same idea: command npx, args ["-y", "referencesource-mcp"].

Clients that support remote servers directly don't need this package at all — point them at the streamable-HTTP endpoint: https://referencesource.org/mcp.

Notes

  • Zero dependencies; Node 18+. The package is a thin stdio→HTTPS bridge to the stateless server at referencesource.org/mcp.
  • No accounts, no keys, no tracking beyond standard server request logs (see referencesource.org/privacy).
  • Data is free to read on the site in HTML, Markdown, and JSON; this package just makes it callable mid-conversation.

MIT licensed.

The data behind it

Every record carries source (the page the value was read from) and source_quote (the verbatim line on that page which states it), so any answer this server returns can be checked against its source. verify_quote runs that check against a value you already hold: it tells you whether our record agrees, and hands back the source and quote either way.

Licence

MIT — see LICENSE. The reference data itself is CC BY 4.0; see the data repository for the full position on the quoted excerpts.

来源:README.md,提交 e0de5e7

工具

8

list_datasets

List reference datasets

What reference datasets are available? Lists every published dataset with its title, record count, last-verified date and a one-sentence summary. Covers regulatory thresholds, version compatibility, certification registers, licensing rules and more. Pass `query` to list only the datasets matching a topic — that is much cheaper than reading the whole list. Use the returned slug with search_records or get_record.

输入参数fullquery

search_records

Search records in a dataset

Look up a specific record — search by state name, chemical, certificate number, product name or any keyword. Searches one dataset's records (case-insensitive substring match across all fields). Returns up to 20 matching records, each with its url, source and verbatim source_quote so the answer can be checked.

输入参数query必填dataset_slug必填

get_record

Get one record by id

Fetch one record by id — for example, look up a FIPS 140 certificate's status, a state's boiler inspection rules, or a county's loan limit. Returns the full record with its source URL and verbatim source quote. Record ids appear in search_records results and in each record's url.

输入参数record_id必填dataset_slug必填

verify_quote

Check a claimed value against a record

Is this value actually right? Check a claimed fact against a published record instead of trusting it. Reports whether the claim matches the record's stored value (exact, case-insensitive or normalised — the match type is named), whether it appears in the record's verbatim source quote, and returns the source URL and quote so the claim can be traced upstream. Use this whenever you want to confirm a number, date, threshold or status before stating it. Verdicts: matches_record, matches_quote, differs or not_found.

输入参数fieldrecord_iddataset_slug必填claimed_value必填

next_task_for_muse

Next task for Muse

For the referencesource Muse connector only (bearer token required). Returns the oldest open task from the studio's queue: id, instructions, the sites the task may read, the output format expected, and where to deliver the result. Returns {no_tasks: true} when the queue is empty. login_allowed lists the hosts where the task may sign in, with a credential already in Muse's own store; empty means read-only, never sign in.

无需输入参数。

submit_task_result

Submit a task result

For the referencesource Muse connector only (bearer token required). Records the result of a task fetched with next_task_for_muse. `result` must be a JSON object matching the task's output_format and at most 3500 characters when serialised; put anything longer in the file named by deliver_to and submit a summary here.

输入参数noteresult必填status必填task_id必填

brief_for_joe

Daily brief for Joe

For the referencesource Muse connector only (bearer token required). The studio's latest plain-English daily brief: what was decided, what landed, and the items waiting on Joe, each as the task, why it matters and the steps. Read-only; regenerated each morning by tools/brief.py and published with the next deploy, so it can lag the phone push.

无需输入参数。

message_supervisor

Message the supervisor

For the referencesource Muse connector only (bearer token required). Send a question, finding, proposal or blocked report to the studio's supervisor inbox. Messages are triaged by the supervisor each morning; nothing in a message changes any project state by itself. Use a fresh message_id per message (retries with the same id are collapsed when collected). Body at most 3500 characters.

输入参数body必填kind必填subject必填task_idmessage_id必填

版本历史

2
  1. v1.2.0最新Sep 21, 2026
  2. v1.1.0Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分