Code-MCP

🧠 The AI Coding Brain - A comprehensive MCP server that gives AI assistants superpowers

✨ 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)

# 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)

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):

{
  "mcpServers": {
    "code-mcp": {
      "command": "node",
      "args": ["C:/path/to/Code-MCP/dist/index.js"]
    }
  }
}

2. Add to Cursor

Add to your Cursor MCP settings:

{
  "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

# 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 for guidelines.

📄 License

MIT License - see LICENSE for details.

🔗 Links

• GitHub Repository
• MCP Specification
• Discord Community

---

Made with ❤️ by @millsydotdev