Code-MCP

# Code-MCP > 🧠 **The AI Coding Brain** - A comprehensive MCP server that gives AI assistants superpowers [](LICENSE) [](https://nodejs.org) [](https://www.typescriptlang.org/) ## ✨ What is Code-MCP? Code-MCP is a Model Context Protocol (MCP) server that supercharges AI coding assistants like Claude, Cursor, and GitHub Copilot with **70 functional tools**, **22 smart prompts**, and **142+ resources**. ## 🚀 Features - **71 Functional Tools** - Code generators, validators, helpers - **22 Smart Prompts** - Developer personas deeply integrated with Code-MCP tools - **99 Code Templates** - Production-ready examples - **142+ Resources** - Languages, frameworks, databases ## 📦 Installation ### Local Installation (Recommended) ```bash # Clone the repository git clone https://github.com/millsydotdev/Code-MCP.git cd Code-MCP # Install dependencies npm install # Build the project npm run build # Test locally npm start ``` ### NPX (Coming Soon) ```bash npx code-mcp ``` ## ⚡ Quick Start ### 1. Add to Claude Desktop Edit your Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json` on Windows or `~/Library/Application Support/Claude/claude_desktop_config.json` on Mac): ```json { "mcpServers": { "code-mcp": { "command": "node", "args": ["C:/path/to/Code-MCP/dist/index.js"] } } } ``` ### 2. Add to Cursor Add to your Cursor MCP settings: ```json { "mcpServers": { "code-mcp": { "command": "node", "args": ["/path/to/Code-MCP/dist/index.js"] } } } ``` ### 3. Restart your AI assistant and start using the tools! ## 🛠️ All 71 Tools ### Cognitive Tools (10) | Tool | Description | | ---------------------- | --------------------------------- | | `sequential_thinking` | Step-by-step structured reasoning | | `plan_task` | Create structured task plans | | `reflect_on_code` | Code quality analysis | | `analyze_architecture` | System design review | | `debug_problem` | Systematic debugging approach | | `brainstorm_solutions` | Generate solution approaches | | `compare_approaches` | Compare technical options | | `estimate_complexity` | Task complexity estimation | | `generate_tests` | Test case generation | | `explain_code` | Code explanation at any level | ### Memory Tools (4) | Tool | Description | | --------------- | ---------------------- | | `save_memory` | Persist key-value data | | `read_memory` | Retrieve saved data | | `list_memories` | List all memories | | `clear_memory` | Clear memories | ### Code Generators (6) | Tool | Description | | --------------------- | ------------------------------------------------------------ | | `generate_snippet` | Generate code for 12 patterns (React, Express, Prisma, etc.) | | `regex_builder` | Build regex with explanations | | `typescript_helper` | 11 TypeScript patterns (interfaces, generics, etc.) | | `generate_api_client` | Type-safe fetch/axios clients | | `sql_helper` | 12 SQL operations (queries, migrations, CTEs) | | `validate_code` | Syntax validation | ### Validation Tools (3) | Tool | Description | | --------------- | ----------------------- | | `check_imports` | Check import statements | | `lint_code` | Code linting | | `format_code` | Code formatting | ### File Generators (8) | Tool | Description | | ------------------------ | ---------------------------------------------- | | `generate_package_json` | Complete package.json for 6 project types | | `generate_dockerfile` | Optimized Dockerfiles (Node, Python, Go, Rust) | | `generate_env_template` | Environment variable templates | | `generate_readme` | Complete README.md files | | `generate_license` | License files (MIT, Apache, GPL, etc.) | | `generate_documentation` | Complete project documentation (API, Arch) | | `generate_dashboard` | HTML Project Dashboard | | `git_helper` | Git commands for 12 scenarios | ### Advanced Tools (6) | Tool | Description | | --------------------- | --------------------------------------------------- | | `typescript_helper` | 11 TypeScript patterns (interfaces, generics, etc.) | | `generate_api_client` | Type-safe fetch/axios clients | | `sql_helper` | 12 SQL operations (queries, migrations, CTEs) | | `graph_db_helper` | Graph DB queries (Cypher) for common operations | | `generate_readme` | Complete README.md files | | `generate_license` | License files (MIT, Apache, GPL, etc.) | ### AI Config Generators (7) | Tool | Description | | -------------------------- | --------------------------- | | `generate_cursor_rules` | .cursorrules file | | `generate_claude_config` | CLAUDE.md file | | `generate_gemini_config` | GEMINI.md file | | `generate_copilot_config` | GitHub Copilot instructions | | `generate_windsurf_config` | Windsurf rules | | `generate_aider_config` | Aider configuration | | `generate_cline_config` | Cline/Roo Code rules | ### IDE Config Generators (5) | Tool | Description | | --------------------------- | --------------------- | | `generate_continue_config` | Continue.dev config | | `generate_tabnine_config` | Tabnine config | | `generate_vscode_tasks` | VSCode tasks.json | | `generate_vscode_launch` | VSCode launch.json | | `generate_jetbrains_config` | JetBrains run configs | ### Full-Stack Tools (5) | Tool | Description | | --------------------------- | -------------------------- | | `track_project` | Project structure analysis | | `check_dependencies` | Dependency health check | | `generate_github_actions` | CI/CD workflows | | `full_stack_scaffold` | Complete project scaffold | | `developer_rules` | Best practices checklist | | `enforce_project_standards` | Enforce standards | ## 💡 Recommended Workflows Combine tools for maximum effect: ### 1. New Feature Implementation `plan_task` → `sequential_thinking` → `generate_snippet` → `generate_tests` ### 2. Refactoring Legacy Code `project_profiler` → `analyze_complexity` → `reflect_on_code` → `generate_tests` ### 3. Systematic Debugging `debug_problem` → `read_file_snippet` → `search_files` → `explain_code` ### 4. Project Setup `track_project` → `full_stack_scaffold` → `generate_readme` → `generate_github_actions` ### 5. Documentation Update `track_project` → `summarize_files` → `generate_documentation` → `generate_dashboard` ### 6. Agentic CI/CD (Self-Healing) `check_dependencies` → `security_scan` → `analyze_complexity` → `generate_pr_description` ## 💬 22 Smart Prompts | Prompt | Description | | ------------------------- | ------------------------- | | `setup_project` | Initialize a new project | | `act_as_architect` | System design perspective | | `act_as_debugger` | Systematic debugging | | `act_as_reviewer` | Code review mindset | | `act_as_security_auditor` | Security analysis | | `act_as_mentor` | Teaching approach | | `act_as_devops` | DevOps/SRE perspective | | `act_as_tester` | Testing mindset | | `act_as_optimizer` | Performance focus | | `write_example_code` | Generate examples | | `act_as_backend_dev` | Backend development | | `act_as_frontend_dev` | Frontend development | | `act_as_data_engineer` | Data pipelines | | `act_as_mobile_dev` | Mobile development | | `act_as_sre` | Site reliability | | `act_as_api_designer` | API design | | `act_as_dba` | Database administration | | `act_as_tech_writer` | Documentation | | `act_as_teacher` | Explain concepts | | `act_as_pair_programmer` | Collaborative coding | ## 📚 Resources Code-MCP includes comprehensive registries for: - **Languages** - 55+ programming languages with paradigms and extensions - **Frameworks** - 50+ frameworks (React, Vue, Django, FastAPI, etc.) - **Databases** - 20+ databases (PostgreSQL, MongoDB, Redis, etc.) - **Cloud Providers** - AWS, GCP, Azure, Vercel, Railway, etc. - **APIs** - Discord, Stripe, OpenAI, Twilio integrations - **Game Engines** - Unreal, Unity, Godot, Phaser, Bevy - **UI Frameworks** - Tauri, Electron, HTMX, Alpine.js ## 🧪 Testing Locally ```bash # Build the project npm run build # Run tests npm test # Build Docker image docker build -t code-mcp . # Run the server (uses stdio transport) npm start # Or run in development mode npm run dev ``` ## 📖 Example Usage Once connected, ask your AI: ``` Use generate_snippet to create a React component called UserCard ``` ``` Use git_helper to show me how to squash the last 3 commits ``` ``` Use typescript_helper to generate a discriminated union for API responses ``` ``` Use sql_helper to create a migration for a posts table ``` ## 🤝 Contributing Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ## 📄 License MIT License - see [LICENSE](LICENSE) for details. ## 🔗 Links - [GitHub Repository](https://github.com/millsydotdev/Code-MCP) - [MCP Specification](https://modelcontextprotocol.io) - [Discord Community](https://discord.gg/UzP2fRefKh) --- Made with ❤️ by [@millsydotdev](https://github.com/millsydotdev)