MCP server proxy
Extend MCP server functionality to work as a worker
Overview
MCP server proxy is a tool designed to extend the functionality of MCP servers, allowing them to operate as workers that can handle messages efficiently.
To use the MCP server proxy, you need to import the proxyMessage function from the package and create a server instance. You can then configure message handlers to pass messages to the existing MCP server.
- Extends MCP server capabilities to work as a worker - Allows for efficient message handling between clients and servers - Written in TypeScript for type safety and modern development practices
- Enhancing existing MCP servers with additional message processing capabilities.
- Creating scalable applications that require multiple workers to handle messages.
- Integrating with other services that communicate through MCP servers.
Add to your AI client
Use these steps to connect MCP server proxy in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"cd-mcp-proxy-12beam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"cd-mcp-proxy-12beam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"cd-mcp-proxy-12beam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"cd-mcp-proxy-12beam": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cd-mcp-proxy-12beam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"cd-mcp-proxy-12beam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-cd-mcp-proxy-12beam"
]
}
}
}FAQ
What programming language is MCP server proxy written in?
MCP server proxy is written in TypeScript, ensuring type safety and modern coding standards.
Is there any licensing information available?
The project does not specify a license at this time.
How can I contribute to the MCP server proxy?
Contributions can be made through the GitHub repository at https://github.com/12beam/cd-mcp-proxy.