Cadastre

了解你拥有哪些基础设施、各项资源归属何处，以及适用哪些规则。

Cadastre 是面向你的服务器、服务、网络、域名、代码仓库和部署策略的地址簿与规则手册。它为人类和 AI 代理提供一个统一的查询入口，例如：

• 这个应用可以运行在哪里？

• 它必须保持私有，还是可以公开？

• 这个端口或主机名是否已被占用？

• 它归属于哪个流水线和代码仓库？

• 这个答案是当前的、已验证的，还是存在争议的？

Cadastre 将这些事实汇集在一起，说明每个答案的来源，并根据你的规则检查拟议的部署文件。

它是一张地图，而非控制面板。Cadastre 不会部署工作负载、更改 DNS 或 VPN、操作容器，也不会泄露机密值。更新 Cadastre 只更新地图本身；它绝不会改变你的在线基础设施。

为什么使用它？

基础设施知识通常分散在配置文件、仪表盘、工具和人们的记忆中。在有人——或 AI 助手——需要做出安全决策之前，这种方式一直可行。

Cadastre 将这些分散的知识转化为带有来源的答案，并在信息过时、未经验证或存在争议时给出明确警告。调用方无需猜测，即可获得合适的选项、被拒绝的选项、涉及的规则以及背后的证据。

阅读 Cadastre 的用途 获取通俗易懂的讲解和示例。

Related MCP server: codegraph-mcp

使用 Docker 快速开始

使用项目镜像创建一个空的持久化目录：

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  init --data-dir /var/lib/cadastre --empty

然后确认它已就绪：

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  status --data-dir /var/lib/cadastre

main 镜像跟随最新的主分支成功构建。生产部署应固定使用发布流水线发布的带签名不可变摘要。如果你的 Docker 客户端无法看到该软件包，请向 ghcr.io 进行身份验证，或在本地构建镜像。

如需在不创建在线目录的情况下进行探索，请克隆仓库并查询其中的虚构示例：

uv tool install cadastre
cadastre --catalog examples/catalog brief
cadastre --catalog examples/catalog context-for \
  "an internal application that needs a GPU"

继续阅读使用 Cadastre，了解目录设置、常用命令、采集器和远程访问。

可选：Manifest 工作登记簿

Cadastre 还附带一个可选模块，用于回答还有哪些未完成事项、什么最重要、是否已交付。它记录工作项、计划以及与 forge 问题和拉取请求的关联，收集本地 Markdown 任务列表、Git 检出状态和 GitHub issue/PR 证据，并报告声明与 forge 不一致之处——且绝不会向 forge 写入任何内容。

除非目录在 modules.yaml 中启用，否则它处于关闭状态。 如果没有该文件，其模式、OpenAPI 文档、CLI 帮助、HTTP 路由和 MCP 工具列表与一个从未听说过它的构建完全相同。参见使用 Cadastre 以启用它，以及 MANIFEST.md 了解设计。

为 AI 代理而生

本仓库和产品明确对 AI 友好。

Cadastre 提供结构化的 MCP、HTTP、CLI JSON、JSON Schema 和 OpenAPI 接口。答案带有来源和信任状态，context-for 返回与单个决策相关的事实和排除项，check 在部署前审查拟议的工件。AGENTS.md 为编码代理提供仓库级别的说明。

这种设计为代理提供了有用的真实依据，同时不会将 Cadastre 变成基础设施控制平面。

了解更多

许可证

Cadastre 以 MIT 许可证 提供。