关于 Context Atlas
Context Atlas 是面向编码 Agent 和开发者的目录,可按技术栈查找厂商发布的文档、llms.txt 索引、MCP 服务、技能、规则和 CLI。它提供可搜索的条目、主题来源及无状态 MCP 服务。
主要功能
- 01按类型和主题搜索来源
- 02收录文档、MCP 服务、技能和 CLI
- 03提供适配技术栈的 Agent 提示词
- 04以文本和 JSON 提供主题数据
- 05无状态 MCP 搜索与主题工具
适用场景
- 01查找现有技术栈的文档
- 02为项目定位 MCP 服务或技能
- 03规划新技术栈时浏览相关来源
MCP 相关
无状态的 Streamable HTTP MCP 服务提供 `search`、`get_topic` 和 `list_topics` 工具,用于查询目录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://contextatlas.dev/mcpclaude mcp add --transport http levin-staudt-contextatlas https://contextatlas.dev/mcp{"mcpServers":{"levin-staudt-contextatlas":{"type":"http","url":"https://contextatlas.dev/mcp"}}}在 Cursor 中打开{"servers":{"levin-staudt-contextatlas":{"type":"http","url":"https://contextatlas.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"levin-staudt-contextatlas":{"type":"http","url":"https://contextatlas.dev/mcp"}}}{"mcpServers":{"levin-staudt-contextatlas":{"serverUrl":"https://contextatlas.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Context Atlas
线上:https://contextatlas.dev(旧地址 https://contextatlas.levinstaudt.workers.dev 会通过 301 重定向到该地址)
绘制技术栈,或为你现有的技术栈找到合适的资料来源。Context Atlas 汇集了供应商为编码 Agent 发布的 llms.txt 索引、文档、MCP 服务、Agent 技能、规则文件和 CLI,并按云服务提供商、框架、标准和 CLI 分组。
此网站只提供来源链接;每个来源均归其供应商所有。
/列出所有来源,可按搜索内容和类型(地图图例)筛选。/agent提供一个复制按钮,可复制一句提示词:用于现有项目时,检测其技术栈并遵循匹配的来源;用于新项目时,提出技术栈建议。此页面还提供添加 MCP 服务的命令。/llms.txt包含 Agent 指令和完整目录;提示词仅链接到该文件。/atlas.json则以 JSON 格式提供相同数据。/llms/<topic-id>.txt包含单个主题的内容,适用于只需要某个工具的来源的 Agent。/mcp是一个无状态 MCP 服务(Streamable HTTP),提供search、get_topic和list_topics工具:claude mcp add --transport http contextatlas https://contextatlas.dev/mcp。/api/topics、/api/topics/<id>和/api/search?q=<words>&kind=<kind>&limit=<n>是供 CLI 使用的 JSON API(#13)。
添加来源
所有内容都位于 packages/core/src/catalog.ts 中。向现有主题添加一个 Source,或添加一个带有 role 和 signals 的新 Topic(Agent 在仓库中检测主题的方式:file(...)、dep(...)、env(...) 或 hint(...))。更新 updatedAt。然后运行 bun run check;目录测试会检查重复 ID、无效 URL 和格式错误的信号。添加来源技能中有详细说明。
网站提供的所有内容都从 SQLite 读取;运行 bun run seed(以及每次部署)时,会根据该文件重建数据库。
开发
使用 Bun 工作区,使用 Hono 处理 Agent 文件、API 和 MCP 请求,使用 React Router(框架模式、服务端渲染、Vite)构建页面,使用 Drizzle 连接 SQLite 并通过 FTS5 搜索,此外还使用 MCP TypeScript SDK 和 Tailwind CSS。
bun install
bun dev # http://localhost:3000, hot reload for the pages, restart on server changes
bun run check # lint, typecheck, tests: run before every commit
bun run build # dist/: single binary (server + pages) + public/ + drizzle/
bun run deploy # deploy main to the VPS through GitHub Actions
| 路径 | 内容 |
|---|---|
packages/core | 目录、数据库架构和迁移、种子数据、查询、搜索、llms.txt 文本。不包含传输层。 |
apps/server | Hono 应用:Agent 文件、JSON API、MCP、静态文件;其他所有路径均交由 apps/web 处理。src/main.ts 是可执行文件(seed、serve),src/dev.ts 是开发服务器。 |
apps/web | 面向用户的页面:React Router 路由、组件和样式。从服务器快照读取目录,不包含数据逻辑。参见 docs/web-frontend.md。 |
apps/redirect | Cloudflare Worker,将旧的 workers.dev URL 通过 301 重定向到新域名。 |
deploy/ | systemd 单元和 VPS 脚本。 |
scripts/ | Cloudflare 设置、VPS 访问、IndexNow ping 和分享图片,均通过工具框架运行。 |
server.json、glama.json | 远程 MCP 服务在官方 MCP Registry 和 Glama 中的条目。 |
docs/deploy.md | 基础设施和运行手册。 |
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。