Code MCP Server
Code-MCP: Connect Claude AI to your development environment through the Model Context Protocol (MCP), enabling terminal commands and file operations through the AI interface.
What is Code MCP Server?
Code MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to code-mcp: connect claude ai to your development environment through the model context protocol (mcp), enabling terminal commands and file operations through the ai interface.
Code-MCP: Connect Claude AI to your development environment through the Model Context Protocol (MCP), enabling terminal commands and file operations through the AI interface.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Code-MCP: Connect Claude AI to your development environment
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx codeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Code MCP Server
Code-MCP bridges Claude AI to your local development environment via the Model Context Protocol, giving the AI assistant direct access to your terminal, file system, and Git operations within a specified project directory. It supports running shell commands, creating and editing files, performing code analysis with pattern matching, and even connecting to remote development machines over SSH. Developers use it to let Claude execute tasks hands-free — running tests, applying patches, reading output, and iterating — without copy-pasting between windows.
Prerequisites
- Python 3.10 or higher installed on the machine running the server
- pip or uv package manager available
- Claude Desktop or another MCP-compatible client
- Git installed (for Git integration features)
- SSH access configured if using remote connectivity
Install Code-MCP
Install the package from GitHub using pip or uv. The one-liner installer handles uv installation automatically on macOS/Linux.
# macOS / Linux one-liner
curl -LsSf https://raw.githubusercontent.com/54yyyu/code-mcp/main/install.sh | sh
# Or install manually with pip
pip install git+https://github.com/54yyyu/code-mcp.git
# Or with uv
uv pip install git+https://github.com/54yyyu/code-mcp.gitRun the automatic setup for Claude Desktop
The code-mcp-setup command detects your Claude Desktop config file and adds the server entry automatically, pointing to your project directory.
# Point to a specific project directory
code-mcp-setup /path/to/your/project
# Or use current directory
code-mcp-setupOr manually edit the Claude Desktop config
If you prefer manual setup, add the server block to claude_desktop_config.json. The args array must contain the absolute path to the project directory the server should operate in.
{
"mcpServers": {
"code": {
"command": "code-mcp",
"args": [
"/path/to/your/project"
]
}
}
}Restart Claude Desktop
Save the config file and restart Claude Desktop to load the new MCP server. The 'code' server will appear in Claude's available tools.
Optional: Install with Jupyter or remote connectivity support
For Jupyter notebook support or SSH-based remote development, install from the corresponding branch.
# Jupyter support
pip install git+https://github.com/54yyyu/code-mcp.git@jupyter
# Remote connectivity
pip install git+https://github.com/54yyyu/code-mcp.git@remote-editCode MCP Server Examples
Client configuration
Minimal claude_desktop_config.json entry for Code-MCP targeting a local project.
{
"mcpServers": {
"code": {
"command": "code-mcp",
"args": [
"/Users/yourname/projects/myapp"
]
}
}
}Prompts to try
Natural language instructions you can give Claude once Code-MCP is connected.
- "Run the test suite and tell me which tests are failing."
- "Create a new file called utils/helpers.py with a function that parses ISO dates."
- "Show me the git log for the last 5 commits."
- "Find all TODO comments in the src/ directory."
- "Run npm run build and show me any errors."Troubleshooting Code MCP Server
'code-mcp: command not found' when starting Claude Desktop
The binary is not in your PATH. Run 'which code-mcp' to check. If missing, re-run the installer or use the full path in the config: set "command" to the absolute path of the code-mcp binary (e.g., "/Users/yourname/.local/bin/code-mcp"). Use 'code-mcp-setup --fix-path' to update existing configs automatically.
Git commands prompt for confirmation or hang
Code-MCP has special handling for git commands that require confirmation for destructive actions. If a command hangs, check Claude's conversation — it may be waiting for you to approve. For non-interactive use, confirm actions explicitly in the prompt (e.g., 'run git reset --hard HEAD, confirmed').
File operations fail with permission errors
The server operates within the project directory passed as an argument. Ensure that directory exists and the user running Claude Desktop has read/write access to it. Do not pass system directories like / or /usr.
Frequently Asked Questions about Code MCP Server
What is Code MCP Server?
Code MCP Server is a Model Context Protocol (MCP) server that code-mcp: connect claude ai to your development environment through the model context protocol (mcp), enabling terminal commands and file operations through the ai interface. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Code MCP Server?
Follow the installation instructions on the Code MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Code MCP Server?
Code MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Code MCP Server free to use?
Yes, Code MCP Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Code MCP Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to Code MCP Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Code MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Code MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.