Aws Instances MCP (model Context Protocol) Server

🚀 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：用於類型驗證，確保數據的準確性和完整性。