AWS Service Reference

🚀 AWS サービスリファレンス MCP サーバー

この MCP サーバーは、AWS のプログラム型サービスリファレンスとやり取りするためのツールを提供します。以下のことが可能です：

• すべての利用可能な AWS サービスをリストする
• 特定の AWS サービスの API 操作を取得する
• 特定の API 操作がサポートする条件キーを取得する
• 特定の API 操作がサポートするリソースタイプを取得する

🚀 クイックスタート

この MCP サーバーを使用することで、AWS のプログラム型サービスリファレンスとのやり取りが容易になります。以下に、インストール方法や使用方法を詳しく説明します。

✨ 主な機能

• 利用可能な AWS サービスの一覧表示
• 特定の AWS サービスの API 操作の取得
• 特定の API 操作がサポートする条件キーの取得
• 特定の API 操作がサポートするリソースタイプの取得

📦 インストール

1. Python 3.10 以上がインストールされていることを確認します。
2. このリポジトリをクローンします。
3. 必要な依存関係をインストールします：

# 仮想環境の作成とアクティブ化（推奨）
python -m venv .venv
source .venv/bin/activate  # Unix/macOS の場合
.venv\Scripts\activate     # Windows の場合

# 依存関係のインストール
pip install -r requirements.txt

💻 使用例

基本的な使用法

サーバーの起動

サーバーを直接起動することができます：

python aws_service_reference.py

Claude Desktop との統合

1. Claude Desktop の設定ファイルを開きます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. サーバーの設定を追加します：

{
    "mcpServers": {
        "aws-service-reference": {
            "command": "python",
            "args": ["/ABSOLUTE/PATH/TO/aws_service_reference.py"]
        }
    }
}

/ABSOLUTE/PATH/TO/ をサーバーファイルを保存した実際のパスに置き換えてください。

3. Claude Desktop を再起動します。

利用可能なツール

このサーバーは 4 つのツールを提供します：

1. list_aws_services: すべての利用可能な AWS サービスを列挙します。
2. get_service_actions: 特定の AWS サービスの API 操作を取得します。
3. get_action_condition_keys: 特定の API 操作がサポートする条件キーを取得します。
4. get_action_resource_types: 特定の API 操作がサポートするリソースタイプを取得します。

Claude での使用例

接続後、Claude に以下のような質問をすることができます：

• "利用可能な AWS サービスはどれですか？"
• "S3 サービスのすべての API 操作を表示してください"
• "s3:PutObject 操作はどの条件キーをサポートしていますか？"
• "ec2:RunInstances 操作で使用できるリソースタイプは何ですか？"

🔧 技術詳細

MCP Inspector を使用したテスト

MCP Inspector を使用してサーバーをテストすることができます：

mcp dev aws_service_reference.py

依存関係

このプロジェクトは以下の依存関係を使用しています（requirements.txt で指定）：

• mcp[cli]>=0.1.0: CLI ツール付きの Model Context Protocol SDK
• httpx>=0.26.0: API リクエストを行うための最新の HTTP クライアント

📚 ドキュメント

トラブルシューティング

問題が発生した場合は、以下の手順を試してください：

1. Python バージョンが 3.10 以上であることを確認します。
2. すべての依存関係が正しくインストールされていることを確認します：

   pip install -r requirements.txt
   

3. Claude Desktop のログを確認します：
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log
4. Claude Desktop の設定で絶対パスを使用していることを確認します。

📄 ライセンス

このプロジェクトは MIT License のもとでオープンソース化されています。