关于 archive
archive 是一项独立、可核查的马萨诸塞州 Lunenburg 镇及学校预算档案,包含文件、数据集和会议记录,供公众及 Agent 研究地方财政。数据中的数字可追溯至来源文件,并注明解读限制。
主要功能
- 01归档 44,463 份文件
- 02提取 319 个数据集
- 03收录 51 个委员会的会议记录
- 04预算数字可追溯来源
适用场景
- 01追溯预算数字的来源文件
- 02查阅镇级记录中的数据集
- 03查找提及特定词语的会议记录
MCP 相关
项目列有 MCP 服务,但所提供的 README 未说明其工具或接口。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://lunenburgbudgetproject.org/mcpclaude mcp add --transport http org-lunenburgbudgetproject-archive https://lunenburgbudgetproject.org/mcp{"mcpServers":{"org-lunenburgbudgetproject-archive":{"type":"http","url":"https://lunenburgbudgetproject.org/mcp"}}}在 Cursor 中打开{"servers":{"org-lunenburgbudgetproject-archive":{"type":"http","url":"https://lunenburgbudgetproject.org/mcp"}}}在 VS Code 中打开{"mcpServers":{"org-lunenburgbudgetproject-archive":{"type":"http","url":"https://lunenburgbudgetproject.org/mcp"}}}{"mcpServers":{"org-lunenburgbudgetproject-archive":{"serverUrl":"https://lunenburgbudgetproject.org/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
8此工具无需参数。
详细介绍
The Lunenburg Budget Project
Lunenburg(马萨诸塞州)镇和学区预算的独立、可核查档案: 44,463 份文档、319 个数据集,以及来自 51 个镇委员会的 12,252 份议程和会议纪要。与 Lunenburg 镇、学校委员会或学区均无关联。
网站位于 https://lunenburgbudgetproject.org。本仓库包含网站背后的所有内容。
从这里开始:数据 API · MCP 服务 · 所有已发布地址 · Agent 指南。
如果你是 Agent,请从这里开始
请先阅读 fy28/public/llms.txt。 这是专为你编写的:
介绍档案包含什么、不包含什么,以及如何利用数据得出看似可信、实则错误的答案。
如果你能访问网站,请使用网站——下面列出的每个地址都有对应的在线版本,网站提供的内容更精简,并经过索引。如果你只能访问 GitHub,也可以直接获取原始文件;无需克隆:
https://raw.githubusercontent.com/tjloughlin16/lunenburgbudgetapp/main/<path>
| 你想了解 | 获取 |
|---|---|
| 档案包含的内容及其限制 | fy28/public/llms.txt |
| 所有数据集及其行数和大小 | fy28/public/api/tables.json — 共 122 个 |
| 所有表的粒度及其陷阱 | fy28/public/api/schema.json |
| 网站计算的所有数字 | fy28/public/data/model/index.json — 38 个部分,每部分一个文件 |
| 所有来源文档及其 sha256 | sources/data/archive-manifest.csv |
| 哪些会议文档提到了某个词 | fy28/public/minutes/find/README.txt |
fy28/public/api/ 中的文件都可以通过单次请求获取。 任何过大的文件都会拆分
——staff_roster_entries.json 是索引,staff_roster_entries/2022.json 则是对应年份的数据。
文档本身不在本仓库中。 44,463 个文件,共 1.47 GB,存放在公共对象存储中;sources/data/archive-manifest.csv 列出了每个文件及其 sha256,运行 python3 scripts/sync_archive.py --pull 即可获取。提取出的文本位于 sources/*/text/ 下,分析工作读取的正是这些文本。
目录说明
sources/ | 档案,按文档如何到达我们手中分类——请参阅 sources/README.txt |
sources/data/ | 从这些文档中提取的 319 个数据集,格式为 CSV |
sources/analyses/ | 已撰写的分析,每份分析都附有验证脚本 |
model/ | 投影模型——运行 python3 model/export.py 会写入 fy28/src/data/model.json |
scripts/ | 提取、验证和发布脚本 |
fy28/ | 网站:React 应用、Cloudflare Pages Functions 以及所有已发布内容 |
notes/ | 工作笔记;notes/reference/ 为自动生成 |
plans/ | 正在构建的内容及其原因 |
本项目遵循的规则
CLAUDE.md 完整记录了这些规则,每一条都是在这里吃过亏后总结出来的。对于任何阅读数据的人来说,以下四条最重要:
- 绝不在同一项计算中混用预算与实际数。 在某些项目上,两者相差最多达 59%;从一方到另一方计算的增长率,一部分反映增长,另一部分则反映两者之间的差距。
- 预算项目是净额,单位是美元。 它表示扣除拨款、费用和州政府补助后,城镇还需筹集的金额——不是该项目的成本,更绝不是人数。
- 只有事实才会作为事实陈述。 根据数据计算出的数字是事实;对其变化原因的解释则是一个假设,并会明确标注为假设。
- 所有数字都从模型插入,绝不手动写入正文。 包括本文件中的计数。
运行
npm install --prefix fy28
python3 scripts/sync_archive.py --pull # 文档;清单说明了具体内容
python3 model/export.py # -> fy28/src/data/model.json
npm run --prefix fy28 build:site # -> fy28/dist
CLAUDE.md 列出了所有检查项。以下检查项用于确保本文描述的内容符合要求:
python3 scripts/build_readme.py --check # 将本文件与代码库进行核对
python3 scripts/build_api.py # 每个数据集均可获取
node fy28/scripts/check-agents.mjs # 每个公布的 URL 均可访问且可读取
python3 scripts/check_archive_storage.py # 将归档文件与清单进行核对
由 scripts/build_readme.py 生成。请修改该脚本,而不是本文件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。