mcpatlas (Aryasoni98)

MCPAtlas

    ](https://github.com/aryasoni98/mcpatlas/pkgs/container/mcpatlas) 

CNCF环境的MCP服务器 --从任何AI助手查询、比较和贡献2400多个云原生项目。

建筑概览

数据从横向流到MCP服务器；工具、资源和提示将其暴露给AI客户端。

flowchart LR
  subgraph sources[" "]
    L[("CNCF Landscape")]
    G[(GitHub API)]
  end
  subgraph server["mcp-atlas"]
    C[core]
    S[search]
    K[graph]
    C --- S
    C --- K
  end
  subgraph clients[" "]
    Claude[Claude]
    Cursor[Cursor]
    VSC[VS Code]
    Custom[Custom agents]
  end
  L --> C
  G -.-> C
  C --> Claude & Cursor & VSC & Custom

  classDef source fill:#4ECDC4,stroke:#2C8B82,color:#fff
  classDef serverNode fill:#556270,stroke:#3D4A59,color:#fff
  classDef client fill:#E94B3C,stroke:#C23A2E,color:#fff
  class L,G source
  class C,S,K serverNode
  class Claude,Cursor,VSC,Custom client

项目如何在知识图中连接（备选方案、集成、组件）：

flowchart TB
  subgraph kg["Knowledge graph"]
    K8s[Kubernetes]
    Istio[Istio]
    Linkerd[Linkerd]
    Prom[Prometheus]
    K8s --- Istio
    K8s --- Linkerd
    Istio --- Prom
    Linkerd --- Prom
  end
  Tools["get_relationships\nfind_path\nsuggest_stack"]
  kg  Tools

  classDef k8s fill:#326CE5,stroke:#1E4AB8,color:#fff
  classDef mesh fill:#466BB0,stroke:#2D4580,color:#fff
  classDef monitor fill:#E6522C,stroke:#C24120,color:#fff
  classDef tools fill:#F7B731,stroke:#D49B1A,color:#1a1a1a
  class K8s k8s
  class Istio,Linkerd mesh
  class Prom monitor
  class Tools tools

特性

MCP工具（15）

MCP资源

• cncf://landscape/overview --高级景观统计
• cncf://categories/all --所有类别和子类别
• cncf://projects/{name} --动态项目详细信息（通过资源模板）

MCP提示（4）

• evaluate_tool --针对您的用例对CNCF工具进行深入评估
• plan_migration --从一个项目到另一个项目的迁移计划
• review_stack --查看云原生架构堆栈
• onboard_contributor --开始为CNCF项目做出贡献

其他功能

• 自动完成 --项目名称、类别、成熟度级别、关系类型
• 知识图谱 --自动推断关系+130个精心策划的CNCF集成边缘
• 数据缓存 --具有可配置TTL的本地JSON缓存（默认24小时）
• 速率限制 --HTTP传输的可配置并发限制
• 三重运输 --STDIO（内容长度帧）、HTTP/SSE和流式HTTP（MCP 2025-03-26）
• 会话管理 — Mcp-Session-Id 流式HTTP会话的标头
• 跨域资源共享 --浏览器友好的跨源支持所有HTTP端点
• 优雅关闭 --清洁信号/信号处理
• JSON-RPC批处理 --根据JSON-RPC 2.0规范§6，完全支持批处理请求
• 日志记录 --MCP logging/setLevel 用于客户端控制的日志级别
• 普罗米修斯指标 — /metrics 带有项目计数、请求统计信息和正常运行时间的端点
• 分页 --基于偏移量的搜索结果分页 _meta 响应
• 请求取消 — notifications/cancelled 具有飞行中请求跟踪功能
• 内容类型验证 --415非JSON POST请求不支持的媒体类型
• 结构化错误 --JSON-RPC错误 data 工具调用失败中带有工具名称的字段
• 审核日志记录 --每次对stderr的工具调用一行JSON： event, tool, params_hash, status, latency_ms （无个人身份信息）

快速开始

来源

# Clone and build
git clone https://github.com/aryasoni98/mcpatlas.git
cd mcpatlas
cargo build --release

# Run with STDIO transport (for Claude Desktop / Claude Code)
./target/release/mcp-atlas --transport stdio --skip-github

# Run with HTTP transport (for remote clients)
./target/release/mcp-atlas --transport sse --port 3000

# With GitHub enrichment (set token for higher rate limits)
export GITHUB_TOKEN=ghp_...
./target/release/mcp-atlas --transport stdio

码头工人

# Quick run (linux/amd64, linux/arm64)
docker run -p 3000:3000 ghcr.io/aryasoni98/mcpatlas:latest

# With docker-compose (includes health checks and persistent cache)
cd deploy/docker
docker compose up -d

家酿

brew tap aryasoni98/mcpatlas
brew install mcp-atlas

CLI工具

# Sync landscape data locally
cargo run -p mcp-atlas-cli -- sync --skip-github

# Search projects
cargo run -p mcp-atlas-cli -- search "service mesh" --data data/landscape.yml

# Inspect a project
cargo run -p mcp-atlas-cli -- inspect Kubernetes --data data/landscape.yml

# Show statistics
cargo run -p mcp-atlas-cli -- stats --data data/landscape.yml

# Show project relationships
cargo run -p mcp-atlas-cli -- graph Kubernetes --data data/landscape.yml

# Validate landscape file
cargo run -p mcp-atlas-cli -- validate data/landscape.yml

连接到AI工具

克劳德桌面/克劳德代码

添加到MCP设置(~/.claude/settings.json 或Claude桌面配置）：

{
  "mcpServers": {
    "cncf-landscape": {
      "command": "mcp-atlas",
      "args": ["--transport", "stdio", "--skip-github"]
    }
  }
}

光标/VS代码

{
  "mcp.servers": {
    "cncf-landscape": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

可流式HTTP（MCP 2025-03-26）

对于支持最新MCP规范的客户：

# Initialize a session
curl -X POST http://localhost:3000/mcp/stream \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
# Returns Mcp-Session-Id header — include it in subsequent requests

# Use the session
curl -X POST http://localhost:3000/mcp/stream \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: " \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# SSE streaming (set Accept: text/event-stream)
# DELETE /mcp/stream to terminate a session

配置

建筑

mcp-atlas/
├── crates/
│   ├── mcp-atlas-core/      # MCP server, tool handlers, transport
│   ├── mcp-atlas-data/      # Data models, YAML parser, GitHub API, cache
│   ├── mcp-atlas-search/    # Tantivy full-text search index + benchmarks
│   ├── mcp-atlas-graph/     # Knowledge graph engine (relationship inference)
│   ├── mcp-atlas-vector/    # Qdrant + embeddings, hybrid BM25 + vector search
│   ├── mcp-atlas-plugins/   # WASM plugin system (Phase 3)
│   └── mcp-atlas-cli/       # CLI companion tool (9 commands)
├── deploy/
│   └── docker/              # Dockerfile + docker-compose.yml
└── .github/workflows/       # CI + automated data sync

发展

cargo test --workspace        # Run all tests
cargo clippy --workspace      # Lint
cargo fmt --all               # Format
cargo bench -p mcp-atlas-search # Run search benchmarks

# Dev run with local data
cargo run -p mcp-atlas-cli -- sync --skip-github
cargo run -p mcp-atlas-core -- --transport stdio --landscape-file data/landscape.yml --skip-github

文档

这 项目现场 （登录页面和应用内文档）通过GitHub Actions构建和部署（请参阅 .github/workflows/pages.yml).启用GitHub页面时（设置→ 页面→ 来源：GitHub Actions），登陆在 /，应用内文档位于 /docs，以及 mdBook （完整用户指南） /book。该站点还可以部署到 维塞尔 （将根设置为 site; vercel.json 包括在内）。文档存储在Vite应用程序中 /docs （标记在 site/src/content/docs/)在mdBook中 docs/book/ （入门、配置、工具参考、资源、部署、插件开发、贡献）。要在本地构建着陆，请参阅 网站/README.md.要构建本书： mdbook build docs/book （输出单位： docs/book/build/).

在发布之前，运行 ./scripts/verify-release.sh 从repo根目录验证站点构建。

另请参阅 贡献.md, 总经理, 安全.md, ROADMAP.md，以及 代码_OF_CONDUCT.md.

报告使用情况

如果您在生产中使用MCPAtlas或用于重要的非生产用途，我们很乐意收到您的来信：

• 收养人： 将您的组织添加到 采纳者.md 通过pull请求（名称+单行用例）。
• 韵律学： 服务器在以下位置公开Prometheus指标 GET /metrics （请求计数、延迟、工具使用情况）。您可以为自己的仪表板抓取此端点；我们不集中收集使用数据。
• 反馈： 打开一个 问题、想法或成功故事。

许可证

阿帕奇-2.0