Provides a proxy layer to search, describe, and execute tools across multiple MCP servers within a sandboxed environment.
Also known as stackunseen/codemcp, codemcp-cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.5.0
- Last commit
- Nov 3, 2026
- License
- Apache-2.0
What is codemcp MCP?
codemcp provides a proxy layer to search, describe, and execute tools across multiple MCP servers within a sandboxed environment.
Summary generated from the project's README
About codemcp MCP server
Managing and accessing tools from various MCP servers through a single interface is what codemcp enables for developers. It acts as a proxy layer that allows an AI client to search, describe, and execute tools across multiple different servers within a sandboxed environment. By pointing your client to the command npx codemcp-cli serve, you can aggregate your existing tools into one unified connection.
Users can configure the proxy using a codemcp.config.json file, which can be populated automatically by running the import command with the write flag. The system provides visibility into the environment through commands like tools to list every tool and its pin status, or stubs to view the specific TypeScript definitions the model receives. This setup supports both standard stdio transport and programmatic integration via the Proxy class for custom TypeScript implementations.
What you can do with it
- 1Aggregate multiple MCP serversYou can combine tools from several different MCP clients into a single unified proxy connection.
- 2Inspect model tool definitionsDevelopers can view the exact TypeScript code that an AI model will see when interacting with tools.
- 3Programmatic proxy implementationYou can integrate the proxy functionality directly into your own TypeScript applications using the Proxy class.
Written from the project's README. Every use case is checked against a quote from it.
How to install codemcp MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall codemcp MCP in Claude Code
$ claude mcp add codemcp -- npx -y codemcp-cliInstall codemcp MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codemcp": {
"command": "npx",
"args": [
"-y",
"codemcp-cli"
]
}
}
}Install codemcp MCP in VS Code
.vscode/mcp.json
{
"servers": {
"codemcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codemcp-cli"
]
}
}
}Install codemcp MCP in VS Code CLI
$ code --add-mcp '{"name":"codemcp","type":"stdio","command":"npx","args":["-y","codemcp-cli"]}'Install codemcp MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codemcp": {
"command": "npx",
"args": [
"-y",
"codemcp-cli"
]
}
}
}Install codemcp MCP in Codex
$ codex mcp add codemcp -- npx -y codemcp-cliInstall codemcp MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.codemcp] command = "npx" args = ["-y", "codemcp-cli"]
Install codemcp MCP in Gemini CLI
$ gemini mcp add -s user codemcp npx -- -y codemcp-cliInstall codemcp MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codemcp": {
"command": "npx",
"args": [
"-y",
"codemcp-cli"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablestackunseen/codemcp is public and reachablegithub.com/stackunseen/codemcp ↗Pass
- Package names this repository as its sourcecodemcp-cli names stackunseen/codemcp as sourcenpmjs.com/package/codemcp-cli ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for codemcp-clinpmjs.com/package/codemcp-cli/v/0.5.0#provenance ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/stackunseen/codemcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from codemcp-cliPass
- No critical advisory in the package or its dependencies58 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcodemcp
The codemcp command and the MCP server behind it.
codemcp import --write # discover servers from your MCP clients into codemcp.config.json
codemcp tools # connect and list every tool with its pin status
codemcp stubs --detail full # print the TypeScript the model will see
codemcp serve # run the proxy over stdio
Point your MCP client at npx codemcp-cli serve. It advertises three tools, search, describe and execute, plus any passthrough patterns from the config.
Programmatic use:
import { Proxy } from "codemcp-cli";
const proxy = new Proxy({ config: { servers: { shop: { command: "node", args: ["catalog-server.mjs"] } } } });
await proxy.start();
await proxy.server.connect(transport);
codemcp MCP questions
How do I add codemcp MCP to Claude Code?
Run claude mcp add codemcp -- npx -y codemcp-cli in your terminal. Add --scope user to make it available in every project.
How do I add codemcp MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I discover my existing MCP servers?
You can use the import command to discover servers from your MCP clients and save them to a configuration file.
What tools does the codemcp proxy advertise?
The proxy advertises search, describe, and execute tools, along with any passthrough patterns defined in your configuration.
How can I see the TypeScript definitions the AI model will receive?
You can use the stubs command with the full detail flag to print the TypeScript code that the model will see.