English | 简体中文 | 繁體中文 A context-aware Model Context Protocol (MCP) server that acts as a learning sidecar for AI coding assistants. It helps developers learn from AI-generated code changes through interactive quizzes and provides agents with a persistent project-specific debugging memory. 🎓 learningsession - Interactive Learning Card Trigger: User explicitly requests (e.g., "Quiz me", "Test my un
Add this skill
npx mdskills install SunflowersLwtech/mcp-creator-growthWell-documented MCP server combining interactive learning sessions with persistent debug memory RAG
1# <img src="assets/icon.png" width="48" height="48" align="top" style="margin-right: 10px;"> MCP Creator Growth23[English](README.md) | [简体中文](README_zh-CN.md) | [繁體中文](README_zh-TW.md)45A context-aware **Model Context Protocol (MCP)** server that acts as a learning sidecar for AI coding assistants. It helps developers **learn from AI-generated code changes** through interactive quizzes and provides agents with a persistent **project-specific debugging memory**.67[](https://opensource.org/licenses/MIT)8[](https://www.python.org/downloads/)9[](https://modelcontextprotocol.io/)10[](https://github.com/SunflowersLwtech/mcp_creator_growth/blob/main/DOCKER.md)11[](https://glama.ai/mcp/servers/@SunflowersLwtech/mcp_creator_growth)12[](https://deepwiki.com/SunflowersLwtech/mcp_creator_growth)1314---1516## 🌐 Resources1718| Resource | Description |19|----------|-------------|20| [**Glama MCP Marketplace**](https://glama.ai/mcp/servers/@SunflowersLwtech/mcp_creator_growth) | Official MCP server listing with installation guides |21| [**DeepWiki Documentation**](https://deepwiki.com/SunflowersLwtech/mcp_creator_growth) | AI-generated deep analysis of the codebase |22| [**GitHub Repository**](https://github.com/SunflowersLwtech/mcp_creator_growth) | Source code, issues, and contributions |2324---2526## 🚀 Why Use This?2728| For | Benefit |29|-----|---------|30| **Developers** | Don't just accept AI code—understand it. Request a quiz to verify your grasp of the logic, security, or performance implications. |31| **AI Agents** | Stop solving the same bug twice. The server quietly records debugging solutions and retrieves them automatically when similar errors occur. |3233---3435## 📦 Available Tools3637| Tool | Type | Description |38|------|------|-------------|39| `learning_session` | 🎓 Interactive | Opens a WebUI quiz based on recent code changes. **Blocks** until user completes learning. |40| `debug_search` | 🔍 Silent RAG | Searches project debug history for relevant past solutions. Auto-triggered on errors. |41| `debug_record` | 📝 Silent | Records debugging experiences to project knowledge base. Auto-triggered after fixes. |42| `term_get` | 📚 Reference | Fetches programming terms/concepts. Tracks shown terms to avoid repetition. |4344### Tool Details4546<details>47<summary><b>🎓 learning_session</b> - Interactive Learning Card</summary>4849**Trigger**: User explicitly requests (e.g., "Quiz me", "Test my understanding")5051**Parameters**:52| Parameter | Type | Default | Description |53|-----------|------|---------|-------------|54| `project_directory` | string | `"."` | Project directory path |55| `summary` | string | — | Structured summary of Agent's actions |56| `reasoning` | object | null | 5-Why reasoning (goal, trigger, mechanism, alternatives, risks) |57| `quizzes` | array | auto-generated | 3 quiz questions with options, answer, explanation |58| `focus_areas` | array | `["logic"]` | Focus areas: logic, security, performance, architecture, syntax |59| `timeout` | int | 600 | Timeout in seconds (60-7200) |6061**Returns**: `{"status": "completed", "action": "HALT_GENERATION"}`6263</details>6465<details>66<summary><b>🔍 debug_search</b> - Search Debug History</summary>6768**Trigger**: Auto-called when encountering errors (silent, no UI)6970**Parameters**:71| Parameter | Type | Default | Description |72|-----------|------|---------|-------------|73| `query` | string | — | Error message or description to search |74| `project_directory` | string | `"."` | Project directory path |75| `error_type` | string | null | Filter by error type (e.g., ImportError) |76| `tags` | array | null | Filter by tags |77| `limit` | int | 5 | Maximum results (1-20) |7879**Returns**: `{"results": [...], "count": N}`8081</details>8283<details>84<summary><b>📝 debug_record</b> - Record Debug Experience</summary>8586**Trigger**: Auto-called after fixing bugs (silent, background)8788**Parameters**:89| Parameter | Type | Default | Description |90|-----------|------|---------|-------------|91| `context` | object | — | Error context: `{error_type, error_message, file, line}` |92| `cause` | string | — | Root cause analysis |93| `solution` | string | — | Solution that worked |94| `project_directory` | string | `"."` | Project directory path |95| `tags` | array | null | Tags for categorization |9697**Returns**: `{"ok": true, "id": "..."}`9899</details>100101<details>102<summary><b>📚 term_get</b> - Get Programming Terms</summary>103104**Available Domains**: programming_basics, data_structures, algorithms, software_design, web_development, version_control, testing, security, databases, devops105106**Parameters**:107| Parameter | Type | Default | Description |108|-----------|------|---------|-------------|109| `project_directory` | string | `"."` | Project directory path |110| `count` | int | 3 | Number of terms (1-5) |111| `domain` | string | null | Filter by domain |112113**Returns**: `{"terms": [...], "count": N, "remaining": N}`114115</details>116117---118119## 🛠️ Installation120121### One-Line Install (Recommended)122123<table>124<tr>125<th>Platform</th>126<th>Command</th>127</tr>128<tr>129<td><b>macOS / Linux</b></td>130<td>131132```bash133curl -fsSL https://raw.githubusercontent.com/SunflowersLwtech/mcp_creator_growth/main/scripts/install.sh | bash134```135136</td>137</tr>138<tr>139<td><b>Windows (PowerShell)</b></td>140<td>141142```powershell143irm https://raw.githubusercontent.com/SunflowersLwtech/mcp_creator_growth/main/scripts/install.ps1 | iex144```145146</td>147</tr>148</table>149150The installer will:1511. Auto-detect your Python environment (uv → conda → venv)1522. Clone the repository to `~/mcp-creator-growth`1533. Create virtual environment and install dependencies1544. Print the exact command to configure your IDE155156### Manual Installation157158<details>159<summary>Click to expand manual installation steps</summary>160161**Prerequisites**: Python 3.11+ or [uv](https://docs.astral.sh/uv/)162163```bash164# 1. Clone the repository165git clone https://github.com/SunflowersLwtech/mcp_creator_growth.git166cd mcp_creator_growth167168# 2. Create virtual environment and install169# Using uv (recommended)170uv venv --python 3.11 mcp-creator-growth171source mcp-creator-growth/bin/activate # macOS/Linux172# mcp-creator-growth\Scripts\activate # Windows173uv pip install -e '.[dev]'174175# Or using standard venv176python -m venv mcp-creator-growth177source mcp-creator-growth/bin/activate # macOS/Linux178# mcp-creator-growth\Scripts\activate # Windows179pip install -e '.[dev]'180```181182</details>183184### Docker Installation185186<details>187<summary>Click to expand Docker installation steps</summary>188189**Prerequisites**: Docker installed on your system190191```bash192# 1. Pull from Docker Hub193docker pull sunflowerslwtech/mcp-creator-growth:latest194195# Or build locally196git clone https://github.com/SunflowersLwtech/mcp_creator_growth.git197cd mcp_creator_growth198docker build -t mcp-creator-growth .199200# 2. Run with Docker201docker run -i mcp-creator-growth202203# 3. Or use Docker Compose204docker-compose up -d205```206207For detailed Docker usage, persistent storage, and Claude Desktop integration, see **[DOCKER.md](DOCKER.md)**.208209</details>210211---212213## ⚙️ IDE Configuration214215### Claude Code (CLI) — One Command Setup216217After installation, configure your AI coding IDE to use this MCP server.218219### Claude Code220221**Option 1: CLI (Recommended)**222```bash223# macOS / Linux224claude mcp add mcp-creator-growth -- ~/mcp-creator-growth/mcp-creator-growth/bin/mcp-creator-growth225226# Windows227claude mcp add mcp-creator-growth -- %USERPROFILE%\mcp-creator-growth\mcp-creator-growth\Scripts\mcp-creator-growth.exe228```229230**Option 2: Config File**231232Add to `~/.claude.json`:233```json234{235 "mcpServers": {236 "mcp-creator-growth": {237 "command": "~/mcp-creator-growth/mcp-creator-growth/bin/mcp-creator-growth"238 }239 }240}241```242243For Windows:244```json245{246 "mcpServers": {247 "mcp-creator-growth": {248 "command": "C:\\Users\\YourName\\mcp-creator-growth\\mcp-creator-growth\\Scripts\\mcp-creator-growth.exe"249 }250 }251}252```253254Example paths:255- Unix (uv): `~/mcp-creator-growth/mcp-creator-growth/bin/mcp-creator-growth`256- Windows (uv): `C:\\Users\\YourName\\mcp-creator-growth\\mcp-creator-growth\\Scripts\\mcp-creator-growth.exe`257- Windows (conda): `C:\\Users\\YourName\\anaconda3\\envs\\mcp-creator-growth\\Scripts\\mcp-creator-growth.exe`258259Path breakdown (Unix example):260- `~/mcp-creator-growth` → repository directory261- `mcp-creator-growth` → virtual environment directory created by uv/venv262- `bin/mcp-creator-growth` → executable263264### Cursor265266Add to Cursor MCP settings (Settings → MCP → Add Server):267268```json269{270 "mcp-creator-growth": {271 "command": "~/mcp-creator-growth/mcp-creator-growth/bin/mcp-creator-growth"272 }273}274```275276For Windows:277```json278{279 "mcp-creator-growth": {280 "command": "C:\\Users\\YourName\\mcp-creator-growth\\mcp-creator-growth\\Scripts\\mcp-creator-growth.exe"281 }282}283```284285### Windsurf286287Add to `~/.codeium/windsurf/mcp_config.json`:288289```json290{291 "mcpServers": {292 "mcp-creator-growth": {293 "command": "~/mcp-creator-growth/mcp-creator-growth/bin/mcp-creator-growth"294 }295 }296}297```298299### Docker Configuration300301To use Docker with any MCP-compatible IDE:302303```json304{305 "mcpServers": {306 "mcp-creator-growth": {307 "command": "docker",308 "args": [309 "run",310 "-i",311 "--rm",312 "-v",313 "/path/to/your/project:/workspace",314 "-w",315 "/workspace",316 "mcp-creator-growth"317 ]318 }319 }320}321```322323See **[DOCKER.md](DOCKER.md)** for detailed Docker configuration examples for Claude Desktop, Cursor, and other IDEs.324325### Other IDEs326327For any MCP-compatible IDE, use these settings:328- **Command:** `<install-path>/mcp-creator-growth/bin/mcp-creator-growth` (or `mcp-creator-growth\Scripts\mcp-creator-growth.exe` on Windows)329- **Transport:** stdio330331**After configuration, restart your IDE.**332333## Usage334335### Available Tools336337| Tool | Trigger | For | Returns |338|------|---------|-----|---------|339| `learning_session` | User explicit request | **User** | `{status, action}` - minimal |340| `debug_search` | Automatic (on error) | **Agent** | Compact summaries |341| `debug_record` | Automatic (after fix) | **Agent** | `{ok, id}` - minimal |342343### For Users: Learning Session344345Say to your AI assistant:346- "Quiz me on this change"347- "Test my understanding"348- "Help me learn about what you did"349350The agent will create an interactive learning card and **wait** until you complete it.351352> **Note**: Quiz scores are saved locally for your self-tracking but are NOT returned to the agent - this keeps the context clean.353354### For Agents: Debug Tools355356The debug tools work silently in the background:357- **Search first**: When encountering errors, agent searches past solutions358- **Record after**: When fixing errors, agent records the solution359- **Progressive disclosure**: Returns compact summaries, not full records360- **Fast lookups**: Uses inverted index for keyword-based searches361362## Updating363364### One-Line Update (Recommended)365366The remote update script automatically detects your installation and works with **any path format** (including Chinese/non-ASCII paths):367368<table>369<tr>370<td><b>macOS / Linux</b></td>371<td>372373```bash374curl -fsSL https://raw.githubusercontent.com/SunflowersLwtech/mcp_creator_growth/main/scripts/update.sh | bash375```376377</td>378</tr>379<tr>380<td><b>Windows (PowerShell)</b></td>381<td>382383```powershell384irm https://raw.githubusercontent.com/SunflowersLwtech/mcp_creator_growth/main/scripts/update.ps1 | iex385```386387</td>388</tr>389</table>390391The update script will:3921. **Auto-detect** your installation location (supports multiple installations)3932. **Pull** the latest changes from the repository3943. **Force-reinstall** dependencies to ensure version synchronization3954. **Verify** installation integrity and report any issues3965. Detect if MCP server is in use and provide clear instructions397398> **Why remote update?**399> - ✅ Works with Chinese/non-ASCII paths without `cd` navigation400> - ✅ Always uses the latest update logic from the repository401> - ✅ Auto-detects installation location even if you forgot where it is402> - ✅ Handles multiple installations gracefully403404### Local Update (Alternative)405406**macOS / Linux:**407```bash408~/mcp-creator-growth/scripts/update.sh409```410411**Windows (PowerShell):**412```powershell413~\mcp-creator-growth\scripts\update.ps1414```415416### Manual Update417418<details>419<summary>Click to expand manual update steps</summary>420421```bash422# Navigate to installation directory423cd ~/mcp-creator-growth # or your custom installation path424425# Pull latest changes426git pull origin main427428# Update dependencies429# Using uv430source mcp-creator-growth/bin/activate # macOS/Linux431# mcp-creator-growth\Scripts\activate # Windows432uv pip install -e '.[dev]' --upgrade433434# Or using standard venv435source mcp-creator-growth/bin/activate # macOS/Linux436# mcp-creator-growth\Scripts\activate # Windows437pip install -e '.[dev]' --upgrade438```439440</details>441442---443444## 🖼️ Screenshots445446### Learning Session WebUI447448449450---451452## 🔒 Security & Privacy453454| Aspect | Details |455|--------|---------|456| **Local First** | All data stored in `.mcp-sidecar/` directory within your project |457| **No Telemetry** | Zero data sent to external servers |458| **Full Control** | Delete `.mcp-sidecar/` anytime to reset all data |459460---461462## 🔮 Roadmap463464We're building toward a **Personalized Learning Center** that grows with you. Here's what's coming:465466### 🔍 Advanced Search & Indexing (v1.2)467468| Feature | Description |469|---------|-------------|470| **SQLite FTS5** | Full-text search with Chinese support, prefix matching, and boolean queries |471| **BM25 Ranking** | Industry-standard relevance scoring for better search results |472| **Semantic Search** | Vector embeddings for meaning-based matching (e.g., "权限错误" finds "permission denied") |473| **Cross-project Search** | Search debug experiences across all your projects |474475### 📱 Mobile App (v2.0)476477| Feature | Description |478|---------|-------------|479| **Learning History Sync** | Access your quiz history and learning progress on mobile |480| **Spaced Repetition** | Smart review scheduling based on forgetting curves |481| **Offline Mode** | Learn anywhere, sync when connected |482| **Push Notifications** | Gentle reminders to review concepts you're forgetting |483484### 🎯 Personalized Learning Center (v2.5)485486| Feature | Description |487|---------|-------------|488| **Knowledge Graph** | Visual map of concepts you've learned and their connections |489| **Weakness Analysis** | AI identifies areas where you struggle and suggests focused practice |490| **Learning Streaks** | Gamification to keep you motivated |491| **Team Insights** | (Optional) Share anonymized learning patterns with your team |492493### 🤖 AI Enhancements (v3.0)494495| Feature | Description |496|---------|-------------|497| **Adaptive Quizzes** | Questions adjust difficulty based on your performance |498| **Code Pattern Recognition** | Learn from patterns in your own codebase |499| **Multi-language Support** | Explanations in your preferred language |500| **Voice Interface** | "Hey Claude, quiz me on what we did yesterday" |501502> **Want to influence the roadmap?** [Open an issue](https://github.com/SunflowersLwtech/mcp_creator_growth/issues) or join the discussion!503504---505506## 🔧 Environment Variables507508| Variable | Default | Description |509|----------|---------|-------------|510| `MCP_DEBUG` | `false` | Enable debug logging (`true`, `1`, `yes`, `on`) |511| `MCP_TIMEOUT` | `120000` | MCP server startup timeout in ms |512| `MAX_MCP_OUTPUT_TOKENS` | `25000` | Maximum tokens for MCP output |513514---515516## 🤝 Contributing517518We welcome contributions! Please follow these steps:5195201. Fork the repository5212. Create a feature branch: `git checkout -b feature/amazing-feature`5223. Install dev dependencies: `uv pip install -e '.[dev]'`5234. Make changes and run tests: `pytest`5245. Submit a Pull Request525526See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.527528---529530## 📬 Contact531532| Channel | Address |533|---------|---------|534| **Email** | sunflowers0607@outlook.com |535| **Email** | weiliu0607@gmail.com |536| **GitHub Issues** | [Open an Issue](https://github.com/SunflowersLwtech/mcp_creator_growth/issues) |537538---539540## 📄 License541542This project is licensed under the [MIT License](LICENSE).543544---545546<p align="center">547 Built with <a href="https://github.com/jlowin/fastmcp">FastMCP</a> •548 <a href="https://modelcontextprotocol.io">MCP Standard</a> •549 <a href="https://glama.ai/mcp/servers/@SunflowersLwtech/mcp_creator_growth">Glama MCP</a>550</p>551
Full transparency — inspect the skill content before installing.