Lambda MCP Server

🚀 Lambda MCP サーバー

Lambda MCP サーバーは、AWS Lambda をベースにした MCP プロトコルをサポートする実装です。以下に詳細な技術ドキュメントを掲載します。

🚀 クイックスタート

クイックデプロイ

リポジトリのクローン

git clone <repository-url>

サーバーディレクトリへの移動

cd server-http-python-lambda

SAM を使用したデプロイ

sam build
sam deploy --guided

⚠️ 重要提示

デプロイ中に、McpAuthToken の入力を求められます。これはエンドポイントを呼び出すために必要な認証トークンです。この実装では AWS API Gateway オーソライザーを使用し、McpAuthToken を環境変数として渡します。必要に応じて他の本番環境用の実装に置き換えることができます。

クライアント設定

クライアントディレクトリへの移動

cd client-http-typescript-docker

補助スクリプトの実行

run-client.sh

✨ 主な機能

新しいツールの追加

server/app.py でデコレータパターンを使用して新しいツールを追加できます。

@mcp_server.tool()
def my_new_tool(param1: str, param2: int) -> str:
    """あなたのツールの説明。
    
    パラメータ:
        param1: パラメータ 1 の説明
        param2: パラメータ 2 の説明
        
    戻り値:
        戻り値の説明
    """
    # あなたのツールの実装
    return f"Processed {param1} with value {param2}"

⚠️ 重要提示

デコレータは以下の処理を自動的に行います。

• 型検証
• リクエスト解析
• レスポンスフォーマット
• エラー処理
• MCP ドキュメント生成

🔧 技術詳細

注意事項

• 作成時点で、TypeScript MCP SDK は HTTP ベースの MCP 通信をサポートする少数（もしくは唯一）の実装です。
• 本番環境では、AWS IAM のベストプラクティスを使用した認証と承認を検討してください。

セキュリティ

セキュリティ問題の通知については、CONTRIBUTING を参照してください。 AWS と Amazon Bedrock のセキュリティについては、AWS セキュリティドキュメント と Amazon Bedrock セキュリティベストプラクティス を参照してください。

📄 ライセンス

このライブラリは MIT-0 License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。

📚 ドキュメント

バージョン更新

バージョン 1.1.0

• API Key 認証を Authorization ヘッダーで渡される Bearer Token 認証に置き換えました。
• API Gateway のカスタムオーソライザーを追加してトークン認証を行います。
• クライアント設定を更新して Bearer Tokens を使用するようにしました。
• MCP 標準に準拠した認証システムを作成しました。
• 変更履歴セクションを追加しました。

バージョン 1.0.0

• 初版をリリースしました。
• AWS Lambda ベースの基本的な MCP サーバー実装です。
• DynamoDB を使用してセッション状態を管理します。
• サンプルツールの実装が含まれています。
• Amazon Bedrock と統合された TypeScript HTTP クライアントがあります。