Aws Instances MCP (model Context Protocol) Server

🚀 AWS インスタンス MCP（モデルコンテキストプロトコル）サーバー

このサーバーは、指定されたリージョンで実行中のAWS EC2インスタンスをAWS SDKを使用して検索およびリストするMCP（モデルコンテキストプロトコル）サーバーです。

🚀 クイックスタート

✨ 主な機能

• 指定されたAWSリージョンの実行中のEC2インスタンスを検索します。
• 複数の利用可能なゾーンをサポートします。
• 以下を含む詳細なインスタンス情報を提供します：
  • インスタンスID
  • インスタンスタイプ
  • パブリックIPアドレス
  • プライベートIPアドレス
  • インスタンス状態

📦 インストール

前提条件

• 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をインストールしていることを確認してください。すでにClaude Desktopを持っている場合は、最新バージョンであることを確認してください。

使用する各MCPサーバーに対してClaude Desktopを構成する必要があります。これを行うには、テキストエディタで~/Library/Application Support/Claude/claude_desktop_config.jsonファイルを開きます（ファイルが存在しない場合は作成します）。

次に、mcpServersキーの下にサーバーを追加します。少なくとも1つのサーバーが正しく構成されている場合にのみ、MCPインターフェイス要素がClaude Desktopに表示されます。

この場合、以下のように単一の天気サーバーを追加します：

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "node",
            "args": [
                "/絶対パス/親フォルダ/aws-mcp-server/build/index.js"
            ]
        }
    }
}

トラブルシューティング

• AWS認証情報が適切なEC2読み取り権限を持っていることを確認します。
• Claude Desktopアプリが最新バージョンであることを確認します。
• すべての依存関係が正しくインストールされていることを確認します。

💻 使用例

基本的な使用法

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

📚 ドキュメント

ツール

• get-aws-instances：指定されたリージョンの実行中のAWSインスタンスのリストを取得します。

🔧 技術詳細

このサーバーは以下の技術を使用しています：

• MCP
• TypeScript
• AWS SDK
• モデルコンテキストプロトコル（MCP）
• Zodを使用した型検証