ストランドエージェントMCP

Strandsエージェントを実行するためのモデルコンテキストプロトコル（MCP）サーバー。このプロジェクトは、StrandsエージェントをAmazon Qやその他のMCP互換システムと簡単に統合する方法を提供します。

概要

Strands Agent MCPは、Strandsエージェントフレームワークとモデルコンテキストプロトコル（MCP）間のブリッジです。これにより、以下のことが可能になります。

StrandsエージェントをMCPツールとして登録する
MCP を通じて Strands エージェントを実行する
利用可能なエージェントの検出とリスト

このプロジェクトでは、コアコードを変更せずに新しいエージェントを簡単に追加できるプラグインアーキテクチャを使用しています。

Related MCP server: Elasticsearch MCP Server

インストール

pip install strands-agent-mcp

使用法

MCPサーバーの起動

strands-agent-mcp

これにより、デフォルトのポートで MCP サーバーが起動します。

エージェントプラグインの作成

新しいエージェントプラグインを作成するには、名前がsap_mcp_plugin_で始まる Python パッケージを作成します (sap は strands agent plugin の略です)。パッケージには、指定されたレジストリに 1 つ以上のエージェントを登録するregister_plugin関数を実装する必要があります。

from strands import Agent
from strands.models import BedrockModel
from strands_agent_mcp.registry import Registry

def register_plugin(registry: Registry) -> None:
    registry.register("my-agent", Agent(
        model=BedrockModel(boto_session=Session(region_name="us-west-2")))
    )

Amazon Qでの使用

MCP サーバーが実行される場合は、Amazon Q でエージェントを使用できます。

q chat --mcp-server http://localhost:8000

その後、チャットで次のコマンドを使用できます。

利用可能なエージェントの一覧: strands___list_agents
エージェントを実行します: strands___execute_agentパラメータagent (エージェント名) とprompt (エージェントに送信するプロンプト)

建築

このプロジェクトは、次の 3 つの主要コンポーネントで構成されています。

サーバー: エージェント実行APIを公開するMCPサーバー
レジストリ: 利用可能なエージェントを管理するためのシンプルなレジストリ
プラグイン: エージェントをレジストリに登録する動的に検出されたモジュール

サーバーは、命名規則に従うすべてのインストール済みプラグインを自動的に検出し、そのエージェントを登録します。

依存関係

fastmcp : MCPサーバーの実装用
strands-agents : Strands エージェントフレームワークのコア
strands-agents-builder : Strandsエージェントを構築するためのツール
strands-agents-tools : Strandsエージェント用の追加ツール

発達

開発環境をセットアップするには:

リポジトリをクローンする
仮想環境を作成する: python -m venv .venv
仮想環境をアクティブ化します: source .venv/bin/activate (Linux/Mac) または.venv\Scripts\activate (Windows)
開発依存関係をインストールします: pip install -e ".[dev]"

テストプラグインの作成

リポジトリには、「simple-agent」という単純なエージェントを作成して登録する方法を示すサンプルプラグイン ( sap_mcp_plugin_test ) が含まれています。

from boto3 import Session
from strands import Agent
from strands.models import BedrockModel

from strands_agent_mcp.registry import Registry


def register_plugin(registry: Registry) -> None:
    registry.register("simple-agent", Agent(
        model=BedrockModel(boto_session=Session(region_name="us-west-2")))
    )