← 返回目录

Infrawise MCP Server

社区

让 AI 编码助手真正了解你的 AWS 与数据库基础设施

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 60 / 438
Stars: ★ 22 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22+ · Python 3+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前
工具数: 21

64FMRS · C

一个设计严谨、只读、本地优先的确定性基础设施分析 MCP 服务器，提供 21 个工具覆盖 AWS、三大数据库、Kafka 和 IaC 漂移，适合让 AI 编码助手摆脱对基础设施的猜测。代码级关联目前限于 TS/JS/Python。

最强项 · 文档质量 17/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

14/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 仅能看到 README 中引用的 CI/npm-publish 徽章，未提供实际工作流内容或测试文件供核查，无法验证 21 个工具的声明行为与真实实现是否一致，也无法验证 MCP 初始化/工具列表握手是否可复现。按静态评审规则，缺乏可验证的执行证据时可靠性不得超过 12 分，故给出 8 分，扣分原因为证据不足而非假设最优情况。
安全与权限 12/20: README 声称只读、最小权限、凭证不落盘、无遥测，并给出了 DynamoDB 的最小 IAM 策略示例和使用 ${ENV_VAR} 避免明文密码，这些做法值得肯定。但这些均为自述声明，未附带可核查的源码来验证实际调用是否真的限定在只读操作范围内，也未看到对潜在破坏性操作（如误配置连接到生产库)的确认机制说明。命令行通过 npx -y 自动拉取执行第三方包属于 MCP 生态常见模式，非红线问题。综合来看主要风险可见但未能通过代码完全验证，故不满分。
维护活跃度 14/20: 项目非 Archived，MIT 许可证明确，版本号 0.28.1 显示有较多次迭代发布，README 提供了完整的 CONTRIBUTING 与发布流程（pnpm release），并有指向 GitHub Project 看板的路线图。但 star 数少（19，不计入加分)，open issue 仅 1 个信息量有限，未见明确的安全响应渠道或多维护者信息，判断为持续维护但治理信息不完整。
文档质量 17/20: 文档非常详尽：安装、快速开始、21 个工具的说明表、CLI 参考、完整配置示例、AWS 最小权限策略、PostgreSQL 只读用户创建脚本、分析能力分类表、当前已知限制、安全说明及源码目录结构均有覆盖，且明确列出了限制（如 Python 需要 python3、动态构造查询可能无法静态解析）。扣分是因为缺少专门的故障排查（troubleshooting）章节和跨版本兼容性说明，也未展示真实运行截图之外的可复核测试证据。
安装易用性 13/20: 安装路径描述清晰：`npm install -g infrawise` 或 `npx infrawise start --claude`，并自动写入 `.mcp.json`/`.cursor/mcp.json`/`.vscode/mcp.json`，为 Claude Code、Cursor、VS Code 均提供了配置示例，步骤简洁。但按静态评审规则，没有可验证的执行证据（真实运行日志、测试覆盖）时安装易用性不得超过 15 分；此外首次运行需要探测 AWS/数据库环境、可能需要额外的 IAM 权限与连接串配置，实际复杂度可能高于文档所述的“一步到位”，故给 13 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络连接数据库

适合谁

使用 AWS + TypeScript/JavaScript/Python 的开发团队
希望 AI 编码助手基于真实基础设施而非猜测生成代码的开发者
需要在 CI 中做基础设施反模式门禁的工程团队

不适合谁

不使用 AWS 或所列数据库/消息服务的项目
需要基础设施供给/变更执行的工具（Infrawise 只读）
TypeScript/JS/Python 之外语言的代码级关联分析（仅能使用基础设施层分析）

所需权限

AWS 凭证（现有凭证链，至少 dynamodb:ListTables/DescribeTable，完整只读 IAM 策略见文档）
可选的只读 PostgreSQL/MySQL/MongoDB 连接（建议只读用户）
SSO 配置需先执行 aws sso login

风险与副作用

通过 AWS API 和数据库连接读取基础设施元数据；虽为只读且本地运行，仍应使用最小权限凭证
Python 代码扫描需要 PATH 上的 python3
某些供应链扫描器可能因 'infra' 前缀误报 'deceptive naming'（作者声明为误报，项目独立无商标关联）
大型 monorepo 可能需要未来的增量分析优化

安装接入

准备工作

运行环境：Node.js 22+ · Python 3+

DB_PASSWORD 可选密钥用于 postgres 连接字符串 ${DB_PASSWORD} 替换的数据库密码，通过 infrawise.yaml 中的环境变量替换使用，避免提交明文密码。

需要 Node.js 22+。运行 npm install -g infrawise 或直接 npx infrawise start --claude（也支持 --cursor、--vscode）。start 命令会生成 infrawise.yaml、扫描基础设施并写入编辑器的 MCP 配置文件。之后编辑器自动管理 infrawise serve --stdio 进程；HTTP 方式可运行 infrawise serve 并配置 url 为 http://localhost:3000/mcp。

.mcp.json

{"mcpServers":{"infrawise":{"command":"npx","args":["-y","infrawise","serve","--stdio"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "infrawise": {
      "command": "npx",
      "args": [
        "-y",
        "infrawise",
        "serve",
        "--stdio"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add infrawise -- npx -y infrawise serve --stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 infrawise start --claude 后启动 Claude Code，工具列表中应出现 get_infra_overview 等 21 个工具；调用 get_infra_overview 应返回服务快照和 freshness 标志。

常见排障

运行 infrawise doctor 验证 AWS/数据库访问、配置与仓库扫描
配置中每个服务必须显式 enabled: true，未列出的服务不会连接
缓存 24 小时过期；重大变更后运行 infrawise analyze 强制重新扫描
动态构造的查询可能无法被静态解析
Rediscover：infrawise start --rediscover 重新探测并分析

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我的 Orders DynamoDB 表有哪些分区键、排序键和 GSI？
分析一下 listAllOrders 这个函数有没有全表扫描或缺索引的问题。
给 users 表缺失 email 索引的情况给出具体的 CREATE INDEX SQL。
SQS 队列里哪些没有配置 DLQ 或未加密？

工具能力 21

get_infra_overview 只读

基础设施全量快照：服务、数量、高严重性发现、分析新鲜度与配置标志

get_graph_summary 只读

完整基础设施图：所有节点、边和发现

get_table_schema 只读

指定表/集合的列级 schema：类型、主外键、索引、DynamoDB 键与计费模式、成本信号

analyze_function 只读

分析特定函数的问题：扫描、缺失索引、N+1、触发器事件形状、缺失 IAM 权限

suggest_gsi 只读

为 DynamoDB 表和属性生成精确的 GSI 配置

postgres_index_suggestions 只读

为实际 PostgreSQL 表生成精确的 CREATE INDEX SQL

suggest_mongo_index 只读

为 MongoDB 集合和字段生成精确的 createIndex 命令

mysql_index_suggestions 只读

为 MySQL 表生成精确的 ALTER TABLE ADD INDEX SQL

展开其余 13 个工具

get_queue_details 只读

SQS 队列：DLQ 状态、加密、FIFO 类型、可见性超时、消息数

get_api_routes 只读

API Gateway API（REST/HTTP/WebSocket）：路由、方法、路径与 Lambda 集成

get_topic_details 只读

SNS 主题：订阅数、协议和每个订阅的过滤策略

get_secrets_overview 只读

Secrets Manager：名称、轮换状态和从代码推断的密钥键名（不含值）

get_parameter_overview 只读

SSM Parameter Store：名称、类型、层级（不含值）

get_lambda_overview 只读

Lambda 函数：运行时、内存、超时、执行角色 ARN、触发器、环境变量键名、成本信号

get_eventbridge_details 只读

EventBridge 规则：名称、状态、调度/事件模式、目标函数

get_s3_overview 只读

S3 存储桶：版本控制、加密、公共访问、事件通知

get_log_errors 只读

CloudWatch 错误模式与计数（不含原始日志）

get_stack_outputs 只读

从本地 IaC 文件解析的堆栈输出与跨堆栈导出

get_cognito_overview 只读

Cognito 用户池：MFA 配置、客户端认证流、OAuth 设置、令牌有效期

get_stream_details 只读

Kinesis 流（分片、保留、容量模式）与 MSK 集群（状态、Kafka 版本、Broker）

get_cache_overview 只读

ElastiCache 集群：引擎、传输/静态加密、复制组、故障转移、成本信号

使用场景

在 Claude Code 中生成 DynamoDB/PostgreSQL 查询前获取真实表结构与索引上下文

检测代码中的全表扫描、N+1、热分区等反模式

CI 中用 infrawise check 按严重性阈值阻断部署

对照 IaC 文件检测与已部署状态的漂移

支持客户端

Claude Code

Cursor

GitHub Copilot

依据项目文档列出，未经本站实测。

详细介绍

Infrawise 是一个基于 MCP 的基础设施分析服务器。它静态分析代码库、AWS 云资源、数据库 schema 和 IaC 文件（Terraform/CloudFormation/CDK），通过图引擎和 36 个规则分析器检测全表扫描、缺失索引/GSI、热分区、N+1 查询、缺失 DLQ 等反模式，并通过 21 个 MCP 工具将确定性上下文提供给 Claude Code、Cursor 和 GitHub Copilot 等编辑器。分析完全本地、只读、无 LLM 参与分析、无遥测。支持 stdio 和 HTTP（端口 3000 的 Streamable HTTP）传输。