Self-Evolving MCP Brain

A self-updating MCP (Model Context Protocol) system: analyze design/code inputs with an LLM, converse to refine them, then crystallize approved patterns into a local skill library that MCP agents can read.

Components

Related MCP server: MCPatterns

Prerequisites

1. Python 3.10+ (built on 3.12).

2. The freellmapi proxy running locally on http://localhost:3001 (it is a Node/Docker app, not a Python package).

3. A unified key from the proxy's Keys page.

Setup

python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env        # then edit FREELLMAPI_KEY
set -a; source .env; set +a # export env vars into your shell

Run (Phase 2)

# Terminal A — UI backend
python ui_server.py          # :8000

# Terminal B — frontend
python frontend_server.py    # :3000

Open http://localhost:3000.

Phase status

• Phase 1 ✅ MCP server + resource.

• Phase 2 ✅ Conversational analyzer UI + freellmapi integration.

• Phase 3 ✅ Crystallization pipeline (APPROVE & CRYSTALLIZE button).

• Phase 4 ✅ End-to-end test with a real link.