claude-code-demo.md

Claude Code Demo

This guide walks through running Evolve with Claude Code.

Prerequisites

• Evolve MCP server running (see the installation guide)
• Claude Code installed with credentials configured

Running the Filesystem MCP Server

The demo uses a filesystem MCP server to give Claude Code access to files:

uv run demo/filesystem/server.py demo/filesystem --transport sse --port 8202

Running with Claude Code

(cd demo/workdir && claude)

Add the MCP servers if needed:

claude mcp add --scope local guidelines --transport sse http://localhost:8201/sse
claude mcp add --scope local filesystem --transport sse http://localhost:8202/sse

Test with:

What states do I have teammates in? Read the list from the states.txt file.