CLI Usage

---

Command

uvx strands-mcp-server [OPTIONS]

---

Options

Option	Description
--cwd PATH	Working directory (local mode)
--upstream-url URL	Upstream server (proxy mode)
--system-prompt TEXT	Custom system prompt
--no-agent-invocation	Disable invoke_agent
--debug	Debug logging

---

Local Mode

Expose ./tools/ directory:

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

Claude Desktop:

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

---

Proxy Mode

Bridge stdio ↔ HTTP:

# Terminal 1: Start agent
python agent.py  # http://localhost:8000/mcp

# Terminal 2: Start proxy
uvx strands-mcp-server --upstream-url http://localhost:8000/mcp

Claude Desktop:

{
  "mcpServers": {
    "my-agent": {
      "command": "uvx",
      "args": [
        "strands-mcp-server",
        "--upstream-url", "http://localhost:8000/mcp"
      ]
    }
  }
}

---

Debug Mode

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

Check logs:

tail -f ~/Library/Logs/Claude/mcp*.log