mcpField
C
Context Atlas

Context Atlas

远程服务
contextatlas.dev开发工具04 天前更新

关于 Context Atlas

Context Atlas 是面向编码 Agent 和开发者的目录,可按技术栈查找厂商发布的文档、llms.txt 索引、MCP 服务、技能、规则和 CLI。它提供可搜索的条目、主题来源及无状态 MCP 服务。

主要功能

  1. 01按类型和主题搜索来源
  2. 02收录文档、MCP 服务、技能和 CLI
  3. 03提供适配技术栈的 Agent 提示词
  4. 04以文本和 JSON 提供主题数据
  5. 05无状态 MCP 搜索与主题工具

适用场景

  1. 01查找现有技术栈的文档
  2. 02为项目定位 MCP 服务或技能
  3. 03规划新技术栈时浏览相关来源

MCP 相关

无状态的 Streamable HTTP MCP 服务提供 `search`、`get_topic` 和 `list_topics` 工具,用于查询目录。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://contextatlas.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;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/serverHono 应用:Agent 文件、JSON API、MCP、静态文件;其他所有路径均交由 apps/web 处理。src/main.ts 是可执行文件(seed、serve),src/dev.ts 是开发服务器。
apps/web面向用户的页面:React Router 路由、组件和样式。从服务器快照读取目录,不包含数据逻辑。参见 docs/web-frontend.md。
apps/redirectCloudflare Worker,将旧的 workers.dev URL 通过 301 重定向到新域名。
deploy/systemd 单元和 VPS 脚本。
scripts/Cloudflare 设置、VPS 访问、IndexNow ping 和分享图片,均通过工具框架运行。
server.json、glama.json远程 MCP 服务在官方 MCP Registry 和 Glama 中的条目。
docs/deploy.md基础设施和运行手册。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。