Skip to main content
Glama

Strands Agent MCP

by imgaray
README.md4.25 kB
# Strands Agent MCP A Model Context Protocol (MCP) server for executing Strands agents. This project provides a simple way to integrate Strands agents with Amazon Q and other MCP-compatible systems. <a href="https://glama.ai/mcp/servers/@imgaray/strands-agents-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@imgaray/strands-agents-mcp/badge" alt="Strands Agent MCP server" /> </a> **IMPORTANT**: This project is currently in alpha stage and not yet published on PyPI. ## Overview Strands Agent MCP is a bridge between the Strands agent framework and the Model Context Protocol (MCP). It allows you to: - Register Strands agents as MCP tools - Execute Strands agents through MCP - Find agents by specific skills The project uses a plugin architecture that makes it easy to add new agents without modifying the core code. ## Installation > Note: This package is not yet available on PyPI. You'll need to install it from source. ```bash # Clone the repository git clone https://github.com/yourusername/strands-agent-mcp.git cd strands-agent-mcp # Install the package pip install -e . ``` ## Usage ### Starting the MCP Server ```bash strands-agent-mcp ``` This will start the MCP server. ### Environment Variables The server supports the following environment variables: - `PLUGIN_PATH`: Custom path to look for plugins (default: ".") - `PLUGIN_NAMESPACE`: Custom namespace prefix for plugins (default: 'sap_mcp_plugin') ### Creating Agent Plugins To create a new agent plugin, create a Python package with a name that starts with `sap_mcp_plugin_` (sap stands for strands agent plugin). Your package should implement a `build_agents` function that returns a list of `AgentEntry` objects: ```python from typing import List from boto3 import Session from strands import Agent from strands.models import BedrockModel from strands_agent_mcp.registry import AgentEntry def build_agents() -> List[AgentEntry]: return [ AgentEntry( name="my-agent", agent=Agent( model=BedrockModel(boto_session=Session(region_name="us-west-2")) ), skills=["general-knowledge", "coding"] ) ] ``` ### Using with Amazon Q Once the MCP server is running, you can connect it to Amazon Q. Refer to the Amazon Q documentation for the correct connection parameters. The following MCP tools will be available: - `execute_agent`: Execute an agent with parameters `agent_name` and `prompt` - `list_agents`: List all available agents ## Architecture The project consists of three main components: 1. **Server**: The MCP server that exposes the agent execution API 2. **Registry**: A registry for managing available agents and their skills 3. **Plugins**: Dynamically discovered modules that register agents with the registry The server automatically discovers all installed plugins that follow the naming convention and registers their agents. ## Dependencies - `fastmcp>=2.3.4`: For implementing the MCP server - `strands-agents>=0.1.1`: The core Strands agent framework - `strands-agents-builder>=0.1.0`: Tools for building Strands agents - `strands-agents-tools>=0.1.0`: Additional tools for Strands agents ## Development This project uses [uv](https://github.com/astral-sh/uv) for dependency management. To set up a development environment: 1. Clone the repository 2. Install uv if you don't have it already: `pip install uv` 3. Create a virtual environment and install dependencies: ```bash uv venv uv sync ``` ## Sample Plugin The repository includes a sample plugin (`sap_mcp_plugin_simple`) that demonstrates how to create and register a simple agent: ```python from typing import List from boto3 import Session from strands import Agent from strands.models import BedrockModel from strands_agent_mcp.registry import AgentEntry def build_agents() -> List[AgentEntry]: return [ AgentEntry( name="simple-agent", agent=Agent( model=BedrockModel(boto_session=Session(region_name="us-west-2")) ), skills=["general-knowledge"] ) ] ``` ## License This project is licensed under the terms of the LICENSE file included in the repository.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/imgaray/strands-agents-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server