🚀 AWS 实例 MCP（模型上下文协议）服务器

这是一个借助 AWS SDK 来检索并列出指定区域中运行的 AWS EC2 实例的 MCP（模型上下文协议）服务器，能为用户提供详细的实例信息，助力用户高效管理 AWS 资源。

🚀 快速开始

先决条件

• Node.js（版本 18 或更高）
• AWS 账户
• AWS 访问密钥和秘密密钥

设置说明

1. 克隆仓库

git clone https://github.com/codewithdpk/aws-mcp-server.git
cd aws-mcp-server

2. 安装依赖项

npm install

3. 配置 AWS 凭证

在项目根目录创建一个 .env 文件，并添加您的 AWS 凭证：

AWS_ACCESS_KEY_ID=your_access_key_id
AWS_ACCESS_SECRET_KEY=your_secret_access_key

4. 构建服务器

若要在本地构建服务器，可执行以下命令：

npm run build

5. 使用 Claude Desktop 进行测试

Claude Desktop 目前在 Linux 上不可用。Linux 用户可按照“构建一个客户端”教程构建一个 MCP 客户端，该客户端可连接到我们刚刚构建的服务器。

首先，请确保您安装了最新版本的 Claude Desktop。若已安装，请确保其为最新版本。

我们需要为每个要使用的 MCP 服务器配置 Claude Desktop。为此，请在文本编辑器中打开 ~/Library/Application Support/Claude/claude_desktop_config.json 文件（若文件不存在，则创建它）。

然后，在 mcpServers 键下添加您的服务器。只有当至少一个服务器正确配置时，MCP 界面元素才会在 Claude Desktop 中显示。

在本例中，我们将按如下方式添加单一天气服务器：

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "node",
            "args": [
                "/绝对路径/到父文件夹/aws-mcp-server/build/index.js"
            ]
        }
    }
}

故障排除

• 验证 AWS 凭证是否具备适当的 EC2 读取权限
• 确保 Claude Desktop App 为最新版本
• 检查所有依赖项是否正确安装

✨ 主要特性

• 可检索指定 AWS 区域的运行中的 EC2 实例。
• 支持多个可用区。
• 提供详细的实例信息，涵盖：
  • 实例 ID
  • 实例类型
  • 公共 IP 地址
  • 私有 IP 地址
  • 实例状态

📦 安装指南

按照上述“设置说明”中的步骤，依次完成仓库克隆、依赖项安装、AWS 凭证配置、服务器构建和测试配置，即可完成服务器的安装与配置。

💻 使用示例

基础用法

server.tool("get-aws-instances", {
  region: "ap-south-1"
})

🔧 技术细节

本项目运用了以下技术：

• MCP（模型上下文协议）：作为服务器的核心协议，用于实现相关功能。
• TypeScript：为项目提供类型检查，增强代码的可维护性和健壮性。
• AWS SDK：借助该 SDK 实现对 AWS 服务的访问和操作。
• Zod：用于类型验证，确保数据的准确性和完整性。