# 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 **68 functional tools**, **22 smart prompts**, and **142+ resources**.
## 🚀 Features
- **68 Functional Tools** - Code generators, validators, helpers
- **22 Smart Prompts** - Developer personas and workflows
- **22+ 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 68 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 (6)
| 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.) |
| `git_helper` | Git commands for 12 scenarios |
### 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 |
## 💬 20 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 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)
---
Made with ❤️ by [@millsydotdev](https://github.com/millsydotdev)