使用说明
亚特兰蒂斯MCP服务器
Atlantis MCP（模型上下文协议）服务器为63Klabs Atlantis模板和脚本平台提供人工智能辅助开发功能。它使开发人员能够通过AI助手和IDE发现、验证和利用CloudFormation模板、入门代码和文档。
特性
- 模板发现：在多个S3存储桶中浏览和搜索CloudFormation模板
- 模板检索：获取包含元数据、参数和输出的完整模板内容
- 版本管理：列出模板版本并检查更新
- 初学者代码发现：查找并探索预配置的应用程序启动器
- 文档搜索：在文档、教程和代码模式中搜索
- 命名验证：根据亚特兰蒂斯公约验证资源名称
- 多源支持：聚合来自多个S3存储桶和GitHub组织的数据
- 智能高速缓存：采用多层缓存策略快速响应
- 速率限制：具有可配置速率限制的公共访问
- 认证访问：用户可以自我注册以获得提供更高使用限制的API密钥
快速开始
此应用程序由63Klabs托管，网址为 mcp.atlantis.63klabs.net。但是，您可以选择通过以下方式自主持 部署亚特兰蒂斯mcp.
面向AI助手用户
Atlantis MCP服务器旨在与人工智能助手无缝协作。配置后，您可以要求您的AI助手：
"Show me available CloudFormation templates for storage"
"Get the latest version of the pipeline template"
"Find starter code for a Node.js Lambda function"
"Validate this resource name: acme-myapp-test-MyFunction"
"Search documentation for DynamoDB caching patterns"
看 集成指南 有关特定AI助手的设置说明。
可用的MCP工具
服务器通过MCP协议公开以下工具：
| 工具 | 说明 |
|---|---|
list_templates |
列出所有可用的CloudFormation模板 |
get_template |
获取包含完整内容和元数据的特定模板 |
list_template_versions |
列出特定模板的所有版本 |
list_categories |
列出模板类别（存储、网络、管道等） |
list_starters |
列出可用的应用程序启动代码库 |
get_starter_info |
获取特定启动器的详细信息 |
search_documentation |
搜索文档、教程和代码模式 |
validate_naming |
根据亚特兰蒂斯公约验证资源名称 |
check_template_updates |
检查模板是否有可用的更新版本 |
集成指南
文档
文档分为3个用户组：
当部署管道中启用部署后阶段时，最终用户文档会被聚合并发布到静态网站（CloudFront前面的S3）。
先决条件
用于使用公共实例
无需先决条件-只需配置您的AI助手以连接到公共Atlantis MCP服务器端点。
自助主机
- 具有适当权限的AWS帐户
- Node.js 24.x或更高版本
- AWS-SAM-CLI
- 访问亚特兰蒂斯SAM配置库
- GitHub个人访问令牌（用于私有存储库访问）
缓存策略
MCP服务器使用由 @63klabs/缓存数据NPM包:
- 内存缓存：在Lambda调用中快速访问
- DynamoDB缓存：跨调用共享缓存
- S3缓存：大型物体的长期储存
默认TTL值：
- 模板元数据：24小时
- 初学者元数据：24小时
- 文档索引：24小时
- 完整模板内容：24小时
在BETA发布期间，所有值都设置为24小时。
速率限制
为防止滥用，公共访问受到限制：
- 默认值：每个IP地址每小时50个请求
- 响应中包含的速率限制标头：
X-RateLimit-Limit：允许的最大请求数X-RateLimit-Remaining：当前窗口中剩余的请求X-RateLimit-Reset：限制重置的时间（Unix时间戳）
- 超过限制时返回HTTP 429
Retry-After头球
在BETA版本期间，只有每个IP每hpur限制50个请求的公共访问可用。
多源支持
MCP服务器聚合来自多个来源的数据：
多个S3铲斗
- 通过以下方式配置多个模板桶
ATLANTIS_S3_BUCKETS参数 - 按优先级顺序搜索Buckets
- 需要
atlantis-mcp:Allow=true吊桶上的标签 - 通过以下方式发现命名空间
atlantis-mcp:IndexPriority标签
多个GitHub组织
- 通过以下方式配置多个GitHub用户/组织
ATLANTIS_GITHUB_USER_ORGS参数 - 按优先级顺序搜索的组织
- 通过以下方式过滤存储库
atlantis_repository-type自定义属性 - 自动速率限制处理
布朗支持
即使某些数据源发生故障，MCP服务器也会继续运行：
- 从工作源返回可用数据
- 包括失败源的错误信息
- 记录详细错误以进行故障排除
- 确保部分数据优于无数据
版本信息
- MCP协议版本: 1.0
- AWS Lambda运行时：Node.js 24.x
- 缓存包：@63klabs/缓存数据
相关资源
支持
建筑
看 建筑
部署指南
看 部署指南
高级文档
看 文档目录
AI 上下文
看 代理商.md 了解此存储库中AI生成代码的重要上下文和指导方针。
代理文件对于在应用程序的结构化平台内开发HUMANS也很有帮助（也许是必不可少的）。
更新日志
看 更改日志
安全
看 安全
数据收集和使用
看 隐私
