MCPD Proxy

v1.0.0Developer Toolsstable

mcpd proxy MCP server for IDE integrations

mcpd-proxymcpai-integration
Share:
17
Stars
0
Downloads
0
Weekly
0/5

What is MCPD Proxy?

MCPD Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcpd proxy mcp server for ide integrations

mcpd proxy MCP server for IDE integrations

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • mcpd proxy MCP server for IDE integrations

Use Cases

Integrate MCP servers with IDEs through a proxy layer.
mozilla-ai

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpd-proxy

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPD Proxy

MCPD Proxy is a Mozilla AI project that acts as a single MCP endpoint aggregating multiple MCP servers managed by the mcpd daemon. IDEs and AI clients connect once to the proxy, which forwards requests to the correct backend server and namespaces all tools, resources, and prompts by server name (e.g., github__create_issue). This dramatically simplifies IDE integration when you need access to many MCP servers without configuring each one separately.

Prerequisites

  • Node.js 18 or later with npx available
  • The mcpd daemon running and accessible (default at http://localhost:8090)
  • Claude Desktop, VS Code with MCP support, or another MCP-compatible client
  • npm or npx for running the proxy package
1

Install and run the mcpd daemon

MCPD Proxy requires the mcpd daemon to be running first. Follow the mcpd documentation at github.com/mozilla-ai/mcpd to install and start the daemon, which manages individual MCP server lifecycles.

2

Run the proxy against the daemon

Start the proxy by pointing it at your running mcpd daemon address. By default it connects to http://localhost:8090.

MCPD_ADDR=http://localhost:8090 npx @mozilla-ai/mcpd-proxy
3

Verify tool namespacing

Once running, the proxy exposes all tools from all mcpd-managed servers under the pattern {server}__{tool_name}. Confirm this by connecting with an MCP client and listing available tools.

4

Add the proxy to your IDE or Claude Desktop config

Register the proxy as a single MCP server in your client. All backend servers' tools become accessible through this one entry.

{
  "mcpServers": {
    "mcpd": {
      "command": "npx",
      "args": ["@mozilla-ai/mcpd-proxy"],
      "env": {
        "MCPD_ADDR": "http://localhost:8090"
      }
    }
  }
}
5

Optionally set an API key for daemon authentication

If your mcpd daemon is configured to require authentication, set the MCPD_API_KEY environment variable in addition to MCPD_ADDR.

export MCPD_API_KEY=your-daemon-secret

MCPD Proxy Examples

Client configuration

VS Code MCP settings entry for mcpd-proxy connecting to a local mcpd daemon.

{
  "servers": {
    "mcpd": {
      "type": "stdio",
      "command": "npx",
      "args": ["@mozilla-ai/mcpd-proxy"],
      "env": {
        "MCPD_ADDR": "http://localhost:8090"
      }
    }
  }
}

Prompts to try

Example prompts once the proxy is running and mcpd manages multiple backend servers.

- "List all the tools available through the mcpd proxy."
- "Use the github backend to create an issue titled 'Fix login bug' in my repo."
- "Fetch the resource mcpd://filesystem/home/user/notes.txt via the proxy."
- "What servers is mcpd currently managing and which tools do they expose?"

Troubleshooting MCPD Proxy

Proxy exits immediately with 'connection refused' or cannot reach daemon

Ensure the mcpd daemon is running before starting the proxy. Check that MCPD_ADDR matches the daemon's actual bind address and port. Run `curl http://localhost:8090/health` to test daemon reachability.

Tools from one backend server are missing or not namespaced correctly

Tool names follow the pattern {server}__{tool_name}. Verify the target server is registered and healthy in mcpd by checking mcpd's own status endpoint or logs. Restart the proxy after adding new servers to mcpd.

Authentication error when connecting to the daemon

If the mcpd daemon requires authentication, set MCPD_API_KEY to the matching secret. If no key is needed, ensure MCPD_API_KEY is unset so the proxy does not send an unexpected auth header.

Frequently Asked Questions about MCPD Proxy

What is MCPD Proxy?

MCPD Proxy is a Model Context Protocol (MCP) server that mcpd proxy mcp server for ide integrations It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPD Proxy?

Follow the installation instructions on the MCPD Proxy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPD Proxy?

MCPD Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPD Proxy free to use?

Yes, MCPD Proxy is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "mcpd-proxy": { "command": "npx", "args": ["-y", "mcpd-proxy"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPD Proxy?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides