Architect Knowledge MCP

MCP服务器架构知识

](https://www.npmjs.com/package/@eevenson/architect-knowledge-mcp)

一 MCP（模型上下文协议） 该服务器从精心策划的知识库中提供云架构指导。将其与Claude Desktop、Claude Code、Cursor或任何兼容MCP的客户端一起使用，以获得特定的、清单驱动的架构建议。

知识库里有什么？

• 330+精选文件 涵盖云架构最佳实践
• 供应商： AWS、Azure、GCP、Kubernetes、VMware、Nutanix、Cisco、Dell、HPE、NetApp、Pure Storage、Snowflake、Rancher、Confluent/Kafka、MongoDB、Redis、Elasticsearch、CrowdStrike、Okta、GitLab、ArgoCD等40多个平台
• 顺从： HIPAA、PCI-DSS、SOC2、FedRAMP、GDPR、CCPA、CJIS、ITAR、ISO 27001、NIST/CMMC等
• 模式： 微服务、混合云、边缘计算、AI/ML基础设施、应用程序现代化、安全运营、迁移模式
• 概述： 网络、计算、存储、身份、可观察性、灾难恢复、成本管理、消息传递、供应链安全、性能测试
• 检查表： 每个标记的项目 [Critical], [Recommended]，或 [Optional]

知识库来源于公众 ErikEvenson/建筑师 存储库。不包括客户端数据、项目文件或私人内容。

设置

克劳德桌面版

添加到您的Claude Desktop配置文件（或使用 设置>开发人员>编辑配置):

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "architect-knowledge": {
      "command": "npx",
      "args": ["@eevenson/architect-knowledge-mcp"]
    }
  }
}

重新启动克劳德桌面。当工具可用时，聊天输入的底部将出现一个锤子图标。

克劳德代码

从Claude代码提示符运行以下命令：

claude mcp add architect-knowledge -- npx @eevenson/architect-knowledge-mcp

或者将JSON添加到您的设置中：

{
  "mcpServers": {
    "architect-knowledge": {
      "command": "npx",
      "args": ["@eevenson/architect-knowledge-mcp"]
    }
  }
}

LM 工作室

需要LM Studio 0.3.17+。首选 程序选项卡>安装>编辑mcp.json 并添加：

{
  "mcpServers": {
    "architect-knowledge": {
      "command": "npx",
      "args": ["@eevenson/architect-knowledge-mcp"]
    }
  }
}

其他MCP客户端

适用于任何兼容MCP的客户端，包括Cursor、Windsurf、Cline和Continue。有关如何添加MCP服务器，请参阅客户的文档。

工具

search_knowledge

在知识库中搜索清单、供应商指南和设计模式。

参数：

• query （必填）--自然语言搜索，例如“VMware到Nutanix迁移清单”
• top_k （可选）--最大结果，1-50，默认20
• priority_filter （可选）-- "critical", "recommended"，或 "optional"
• file_filter （可选）--筛选到提供者或类别，例如。 "aws", "compliance/hipaa"

list_categories

浏览可用的知识类别和文件。

参数：

• category （可选）--筛选到一个类别，例如。 "providers/aws", "compliance"

read_file

阅读完整的知识档案。

参数：

• path （必填）--文件路径，例如。 "providers/aws/containers.md"

示例用法

连接后，自然地问架构问题：

• “HIPAA合规性的关键检查表项目是什么？”
• “搜索Kubernetes存储最佳实践”
• “对于VMware到Nutanix的迁移，我应该考虑什么？”
• “显示AWS容器检查表”
• “哪些合规框架涵盖了加密要求？”

Claude将自动调用MCP工具，将其答案放在知识库的精选清单中。

运作原理

1. 首次运行时，从公共GitHub仓库获取知识文件
2. 在本地缓存文件 ~/.cache/architect-knowledge-mcp/
3. 在后续运行中，检查缓存是否是新的（相同的提交SHA）——如果是，则跳过下载
4. 使用轻量级文本搜索（BM25）对所有文件进行索引，以实现即时启动
5. 展示三个MCP工具，用于搜索、浏览和阅读

没有嵌入模型，没有GPU，没有外部数据库。该包大小约为15KB，在初始缓存后立即启动。

数据安全

• 仅从公众处阅读 knowledge/ GitHub仓库中的目录
• 仅允许列出的目录： general, providers, patterns, compliance, frameworks, failures
• 从不访问客户端数据、项目上传或数据库内容
• 完全在您的计算机上运行——除了您已经使用的LLM之外，没有数据发送到任何地方
• 不需要API密钥（可选 GITHUB_TOKEN 避免速率限制的环境变量）

发展

git clone https://github.com/ErikEvenson/architect-knowledge-mcp.git
cd architect-knowledge-mcp
npm install
npm run build
npm test

故障排除

工具未在Claude Desktop中显示？

• 编辑配置后重新启动Claude Desktop
• 查看日志 ~/Library/Logs/Claude/mcp-server-architect-knowledge.log （macOS）
• 验证是否安装了Node.js 18+： node --version

首次启动缓慢？

• 第一次运行从GitHub获取约330个文件（需要15-30秒）
• 后续运行使用本地缓存并立即启动

GitHub限速？

• 集 GITHUB_TOKEN 带有个人访问令牌的环境变量（公共存储库不需要作用域）

许可证

麻省理工学院