Getting Started

---

Install

pip install strands-mcp-server

---

Server Mode

Expose your agent’s tools:

from strands import Agent
from strands_mcp_server import mcp_server

agent = Agent(tools=[mcp_server])
agent("start mcp server on port 8000")
# Running at http://localhost:8000/mcp

---

Client Mode

Connect to remote servers:

from strands import Agent
from strands_mcp_server import mcp_client

agent = Agent(tools=[mcp_client])

# Connect
agent.tool.mcp_client(
    action="connect",
    connection_id="remote",
    transport="http",
    server_url="http://localhost:8000/mcp"
)

# Call tool
agent.tool.mcp_client(
    action="call_tool",
    connection_id="remote",
    tool_name="calculator",
    tool_args={"expression": "42 * 89"}
)

---

CLI Mode

For Claude Desktop:

uvx strands-mcp-server --cwd /path/to/project

Config:

{
  "mcpServers": {
    "my-agent": {
      "command": "uvx",
      "args": ["strands-mcp-server", "--cwd", "/path/to/project"]
    }
  }
}

---

Troubleshooting

Port in use:

lsof -i :8000
kill -9 <PID>

Connection refused:

curl http://localhost:8000/mcp

Tools not loading:

uvx strands-mcp-server --cwd /absolute/path --debug
tail -f ~/Library/Logs/Claude/mcp*.log