Amazon Bedrock AgentCore MCP ServerをClaude Codeで使ってみた

{
  "mcpServers": {
    "awslabs.amazon-bedrock-agentcore-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.amazon-bedrock-agentcore-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

awslabs.amazon-bedrock-agentcore-mcp-serverであなたは何ができるのか教えて

⏺ このMCPサーバーを通じて、私はAmazon Bedrock AgentCoreのドキュメント検索と取得ができます。

  具体的には：

  1. ドキュメント検索
  - AgentCoreの各種機能、API、チュートリアルを検索
  - プラットフォーム概要、セキュリティ、クォータ情報

  2. 完全なドキュメント取得
  - 詳細なガイド、APIリファレンス、サンプルコードの全文取得

  AgentCoreでカバーされる主要サービス：
  - Runtime - サーバーレスデプロイとスケーリング
  - Memory - イベント＆セマンティックメモリによる永続的知識管理
  - Code Interpreter - 安全なコード実行環境
  - Browser - クラウドベースのWebインタラクション
  - Gateway - 既存APIのエージェントツール化
  - Observability - リアルタイムモニタリング
  - Identity - 認証とアクセス管理

  AgentCoreの開発、デプロイ、統合に関する質問があれば、ドキュメントを検索して詳細情報を提供できます。

MCP Serverを活用してStrands Agentsでシンプルなエージェントを作ってみて

search_agentcore_docs(query: "Strands Agents getting started example", k: 3)

fetch_agentcore_doc(uri: "https://aws.github.io/bedrock-agentcore-starter-toolkit/examples/runtime-framework-agents.md")

strands-agents
bedrock-agentcore

"""
シンプルなStrands Agentの例
AgentCore Runtimeでデプロイ可能な基本的な会話エージェント
"""
from strands import Agent, tool
from bedrock_agentcore.runtime import BedrockAgentCoreApp

app = BedrockAgentCoreApp()

# モデルID(Claude 3.7 Sonnet)
MODEL_ID = "us.anthropic.claude-3-7-sonnet-20250219-v1:0"

@tool
def calculate(expression: str) -> str:
    """簡単な算術式を計算します。例: "2 + 2" or "10 * 5"."""
    try:
        result = eval(expression, {"__builtins__": {}}, {})
        return f"計算結果: {result}"
    except Exception as e:
        return f"計算エラー: {str(e)}"

@tool
def get_greeting(name: str) -> str:
    """指定された名前で挨拶メッセージを生成します。"""
    return f"こんにちは、{name}さん！お手伝いできることがあれば教えてください。"

@app.entrypoint
def invoke(payload, context=None):
    """エージェントのエントリーポイント"""
    user_prompt = payload.get("prompt", "こんにちは！")

    agent = Agent(
        model=MODEL_ID,
        system_prompt="あなたは親切なアシスタントです。日本語で対応し、必要に応じてツールを使用してください。",
        tools=[calculate, get_greeting]
    )

    result = agent(user_prompt)
    response_text = result.message.get('content', [{}])[0].get('text', str(result))

    return {"response": response_text}

if __name__ == "__main__":
    app.run()

# 1. 仮想環境を作成してアクティベート
python -m venv .venv
source .venv/bin/activate

# 2. 依存関係をインストール
pip install bedrock-agentcore-starter-toolkit strands-agents boto3

# 3. AgentCoreに設定
agentcore configure -e simple_agent.py

# 4. デプロイ
agentcore launch

# 5. テスト実行
agentcore invoke '{"prompt": "10 * 5を計算して"}'

agentcore invoke '{"prompt": "10 * 5を計算して"}' --bearer-token $JWT_TOKEN
Using bearer token for OAuth authentication
Payload:
{
  "prompt": "10 * 5を計算して"
}
Invoking BedrockAgentCore agent 'simple_agent' via cloud endpoint
Session ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Response:
{
  "response": "{\"response\": \"10 * 5 の計算結果は 50 です。\"}"
}

このエージェントにInbound Authを設定したいのですが、可能でしょうか？MCP Serverで設定方法を確認してね。

⏺ 完了しました！次の手順で進めてください：

  ステップ1: Cognito自動セットアップ

  ./create_cognito.sh

  このスクリプトが自動的に：
  - Cognito User Poolを作成
  - Client IDとSecretを生成
  - テストユーザーを作成
  - 必要な情報（Discovery URL等）を出力

  重要: 出力されるexportコマンドをコピーして実行してください！

  ステップ2: OAuth設定（対話モード）

  agentcore configure -e simple_agent.py

  対話形式で質問されるので：
  1. 「Configure OAuth authorizer instead?」 → Yesを選択
  2. Discovery URL → $ISSUER_URLの値を入力
  3. Allowed Client IDs → $CLIENT_IDの値を入力

  ステップ3: 再デプロイ

  agentcore launch

  ステップ4: JWT Tokenでテスト

  agentcore invoke '{"prompt": "Hello"}' --bearer-token YOUR_JWT_TOKEN

  準備ができたら、まず./create_cognito.shを実行してください！

./create_cognito.sh

# 実行結果
User Pool ID: us-west-2_XXXXXXXXXXXXX
Client ID: xxxxxxxxxxxxxxxxxxxxxxxxxx
Client Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Issuer URL: https://cognito-idp.us-west-2.amazonaws.com/us-west-2_XXXXXXXXXXXXX/.well-known/openid-configuration
Hosted UI URL: https://agentcore-quickstart-XXXXXX.auth.us-west-2.amazoncognito.com
Test User: AgentCoreTestUserXXXX
Test Password: XXXXXXXXXXXXXXXX

export USER_POOL_ID='us-west-2_XXXXXXXXXXXXX'
export CLIENT_ID='xxxxxxxxxxxxxxxxxxxxxxxxxx'
export CLIENT_SECRET='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
export ISSUER_URL='https://cognito-idp.us-west-2.amazonaws.com/us-west-2_XXXXXXXXXXXXX/.well-known/openid-configuration'
export HOSTED_UI_URL='https://agentcore-quickstart-XXXXXX.auth.us-west-2.amazoncognito.com'
export COGNITO_USERNAME='AgentCoreTestUserXXXX'
export COGNITO_PASSWORD='XXXXXXXXXXXXXXXX'

agentcore configure -e simple_agent.py

📋 OAuth Configuration
Enter OAuth discovery URL: https://cognito-idp.us-west-2.amazonaws.com/us-west-2_XXXXXXXXXXXXX/.well-known/openid-configuration
Enter allowed OAuth client IDs (comma-separated): xxxxxxxxxxxxxxxxxxxxxxxxxx
Enter allowed OAuth audience (comma-separated):
✓ OAuth authorizer configuration created

agentcore launch

agentcore invoke '{"prompt": "Hello"}'
Warning: OAuth is configured but no bearer token provided
Payload:
{
  "prompt": "Hello"
}
Invoking BedrockAgentCore agent 'simple_agent' via cloud endpoint
❌ Invocation failed: An error occurred (AccessDeniedException) when calling the InvokeAgentRuntime operation: Authorization method mismatch. The agent is configured for a different
authorization method than what was used in your request. Check the agent's authorization configuration and ensure your request uses the matching method (OAuth or SigV4)

# Cognito JWT Token取得スクリプト
# 使い方: ./get_jwt_token.sh

# 環境変数のチェック
if [ -z "$CLIENT_ID" ] || [ -z "$CLIENT_SECRET" ] || [ -z "$COGNITO_USERNAME" ] || [ -z "$COGNITO_PASSWORD" ]; then
    echo "エラー: 必要な環境変数が設定されていません"
    echo "create_cognito.shの出力から以下をコピーして実行してください:"
    echo "  export CLIENT_ID='...'"
    echo "  export CLIENT_SECRET='...'"
    echo "  export COGNITO_USERNAME='...'"
    echo "  export COGNITO_PASSWORD='...'"
    exit 1
fi

REGION=us-west-2

# SECRET_HASHを計算（HMAC-SHA256(username + client_id, client_secret) を Base64エンコード）
echo "SECRET_HASHを計算中..."
SECRET_HASH=$(echo -n "${COGNITO_USERNAME}${CLIENT_ID}" | openssl dgst -sha256 -hmac "${CLIENT_SECRET}" -binary | base64)

# 認証を実行してトークンを取得
echo "Cognitoで認証中..."
AUTH_RESULT=$(aws cognito-idp initiate-auth \
    --client-id $CLIENT_ID \
    --auth-flow USER_PASSWORD_AUTH \
    --auth-parameters USERNAME=$COGNITO_USERNAME,PASSWORD=$COGNITO_PASSWORD,SECRET_HASH=$SECRET_HASH \
    --region $REGION \
    --query 'AuthenticationResult.AccessToken' \
    --output text)

if [ $? -eq 0 ] && [ -n "$AUTH_RESULT" ]; then
    echo ""
    echo "✅ JWT Token取得成功！"
    echo ""
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    echo "JWT Token:"
    echo "$AUTH_RESULT"
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    echo ""
    echo "環境変数として保存するには:"
    echo "export JWT_TOKEN='$AUTH_RESULT'"
    echo ""
    echo "エージェント呼び出しコマンド例:"
    echo "agentcore invoke '{\"prompt\": \"Hello\"}' --bearer-token \$JWT_TOKEN"
else
    echo "❌ トークン取得失敗"
    exit 1
fi

agentcore invoke '{"prompt": "Hello"}' --bearer-token $JWT_TOKEN
Using bearer token for OAuth authentication
Payload:
{
  "prompt": "Hello"
}
Invoking BedrockAgentCore agent 'simple_agent' via cloud endpoint
Session ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Response:
{
  "response": "{\"response\":
\"こんにちは！私はAIアシスタントです。何かお手伝いできることはありますか？\\n\\n質問や計算、お名前での挨拶など、お気軽にお尋ねください。日本語でお答えしますので、どうぞよろしくお願
いいたします。\"}"
}