CodeMCP is a project-scoped Model Context Protocol server designed for developer workspaces. It connects compatible AI assistants to local project context, file tools, commands, and session memory.

Is my source code uploaded to any third-party cloud servers?

CodeMCP runs against the configured project on your local machine and does not use a hosted indexing service. Remote access is optional and uses an authenticated server endpoint.

How does CodeMCP prevent AI from making unwanted edits?

CodeMCP supports permission modes and approval workflows. When approval is enabled, file and command changes are presented for review before they are applied.

Which AI clients are supported by CodeMCP?

CodeMCP supports compatible MCP clients, including Claude Desktop, Cursor, Cline, Windsurf, and remote clients that can authenticate with its Streamable HTTP OAuth flow.

How do I run CodeMCP?

You can launch CodeMCP in any project directory with a single terminal command: npx codemcp, pnpm dlx codemcp, or bunx codemcp. No global installation is required.

Back to product

COMMAND LINE INTERFACE / V0.1.0

OFFICIAL CLI

Control the bridge
from your terminal.

The CodeMCP CLI boots an intelligent, sandboxed MCP server in milliseconds. Run it where your code lives, configure boundaries with simple flags, and let your AI client connect with zero configuration.

Quick Launch:

$npx codemcp

INTERACTIVE EXPLORER

Explore Common CLI Commands

Click any command below to preview its syntax, options, and simulated terminal execution.

bash — npx codemcp

Ready on stdio / SSE

$ npx codemcp

[mcp] CodeMCP Server v1.1.4 initialized

[mcp] Root: C:\Users\azure\Documents\projects\CodeMCP

[mcp] Config: codemcp.json (loaded)

[mcp] Mode: approval (Prompting before writes/commands)

[mcp] Transport: stdio active, SSE available at http://localhost:4173/mcp

✓ Ready for AI client connections...

Exit code: 0Active transport: stdio / SSE

FULL SPECIFICATION

Flags & Options Reference

Complete list of command-line arguments accepted by the codemcp binary.

Flag / Option	Type	Default	Description
`--project, -p <path>`	string	`"."`	Relative or absolute path to the project root directory exposed to MCP clients.
`--mode, -m <mode>`	string	`"approval"`	Operational security mode: `read-only` (no writes), `approval` (prompt before changes), or `automated`.
`--port <number>`	number	`4173`	Port used when listening for Server-Sent Events (SSE) / HTTP connections.
`--tunnel`	boolean	`false`	Spins up an encrypted HTTPS tunnel, returning a public URL for web assistants like Claude.ai.
`--allow-exec`	boolean	`false`	Enables the `execute_command` tool, allowing the AI to invoke tests and scripts.
`--config, -c <file>`	string	`"codemcp.json"`	Path to a custom configuration file defining boundaries and whitelisted commands.
`--verbose, -v`	boolean	`false`	Outputs raw JSON-RPC protocol frames and tool request payloads to stderr for debugging.
`--help, -h`	boolean	`false`	Displays the CLI usage manual, option flags, and version summary.
`--version`	boolean	`false`	Outputs current installed CodeMCP package version and exits.

ENVIRONMENT VARIABLES

Configuration via Environment

Override flags in automated CI/CD runners, containerized setups, or systemd services.

Variable	Default	Description
`CODEMCP_PROJECT_PATH`	`"."`	Overrides target project root directory.
`CODEMCP_MODE`	`"approval"`	Sets permission mode: `read-only` \| `approval` \| `automated`.
`CODEMCP_PORT`	`4173`	Sets port for HTTP and SSE endpoints.
`CODEMCP_TUNNEL_TOKEN`	`""`	Custom Cloudflare tunnel or ngrok auth token for dedicated domains.
`CODEMCP_LOG_LEVEL`	`"info"`	Log verbosity level: `silent`, `info`, or `debug`.

PRODUCTION RECIPES

Common Deployment Patterns

WORKFLOW 1

Daily Development in Cursor or Claude

Standard interactive workflow. Approvals are prompted directly in your terminal before any file write occurs.

npx codemcp

WORKFLOW 2

Auditing Untrusted Pull Requests

Enforce strict read-only guarantees. The AI can analyze logic and find bugs without any ability to alter files or run commands.

npx codemcp --mode read-only

WORKFLOW 3

Pairing with Web Assistants (Claude.ai)

Exposes a temporary, encrypted TLS tunnel URL that can be plugged into browser-based AI chats.

npx codemcp --tunnel

WORKFLOW 4

Monorepos with Specific Sub-Packages

Scope the assistant strictly to a sub-package (e.g. packages/api) so it never touches unintended modules.

npx codemcp -p ./packages/api

Control the bridgefrom your terminal.