How do I use Code-MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Code-MCP generate a full-stack scaffold for a React + Node.js + PostgreSQL todo app" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Supports containerized deployment of the MCP server using Docker images for consistent runtime environments.

Provides HTTP transport layer for cloud-based MCP server deployments with REST API endpoints.

Enables deployment of the MCP server to Fly.io cloud platform with support for multiple VM instances.

Generates GitHub Actions workflows and supports GitHub repository integration for CI/CD automation.

Generates IDE configuration files for JetBrains products to integrate MCP server tools and resources.

Runs as a Node.js application providing MCP protocol tools for AI-assisted software development.

Supports one-click deployment of the MCP server to Railway cloud platform with built-in hosting template.

Enables deployment of the MCP server to Render cloud platform with 750 hours per month free tier support.

Built with TypeScript providing type-safe MCP tools for code analysis, validation, and project automation.

Code-MCP 🧠

The AI Coding Brain - A comprehensive Model Context Protocol (MCP) server that turns any AI into a full-stack software engineer.

Deploy on Railway

Features

🛠️ 36 MCP Tools

Category	Tools	Purpose
Cognitive (10)	`sequential_thinking`, `plan_task`, `reflect_on_code`, `analyze_architecture`, `debug_problem`, `brainstorm_solutions`, `compare_approaches`, `estimate_complexity`, `generate_tests`, `explain_code`	AI reasoning & analysis
Memory (4)	`save_memory`, `read_memory`, `list_memories`, `clear_memory`	Persistent context
Validation (4)	`validate_code`, `check_imports`, `lint_code`, `format_code`	Code quality
AI Configs (9)	Cursor, Gemini, Claude, Windsurf, Aider, Cline, Copilot, Continue.dev, Tabnine	Generate AI tool configs
IDE Configs (4)	VSCode tasks/launch, JetBrains	IDE integration
Full-Stack (5)	`track_project`, `check_dependencies`, `generate_github_actions`, `full_stack_scaffold`, `developer_rules`	Project automation

📚 130+ MCP Resources

55+ Programming Languages
35+ Databases
43+ Frameworks
DevOps, Security, and more

🎭 5 Smart Prompts

act_as_architect - System design expert
act_as_debugger - Debugging specialist
act_as_reviewer - Code review expert
act_as_security_auditor - Security analyst
setup_project - Project scaffold helper

Quick Start

Local (stdio transport)

git clone https://github.com/millsydotdev/Code-MCP.git
cd Code-MCP
npm install
npm run build
npm start

Cloud (HTTP transport)

npm run start:cloud

Docker

docker build -t code-mcp .
docker run -i code-mcp

Connect to AI Tools

Claude Desktop

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

Cloud Connection

{
  "mcpServers": {
    "code-mcp-cloud": {
      "url": "https://your-deployment.railway.app/mcp",
      "headers": {
        "x-api-key": "your-api-key"
      }
    }
  }
}

Deploy to Cloud

See DEPLOY.md for full deployment instructions.

Platform	Free Tier	Deploy
Railway	500hrs/mo
Render	750hrs/mo	Connect GitHub
Fly.io	3 VMs	CLI deploy

API Endpoints (Cloud Mode)

Endpoint	Method	Description
`/health`	GET	Health check
`/tools`	GET	List all tools
`/tools/:name`	POST	Call a tool
`/resources`	GET	List resources
`/prompts`	GET	List prompts
`/mcp`	POST	MCP JSON-RPC

Environment Variables

PORT=3000
CODE_MCP_API_KEY=your-secret-key  # Optional auth

Tech Stack

Runtime: Node.js
Language: TypeScript
Protocol: Model Context Protocol (MCP)
Server: Express (cloud mode)
Container: Docker

Contributing

Contributions welcome! Feel free to add:

New tools
More language/framework/database rules
Additional AI tool config generators
Improved documentation

License

MIT License - Use freely!

Made with 🧠 by millsydotdev

Code-MCP