Сервер MCP (Model Context Protocol), который выступает в качестве прокси-сервера между IDE и демоном mcpd, выставляя все MCP-серверы, управляемые mcpd, через унифицированный интерфейс.

Обзор

mcpd-proxy объединяет инструменты, ресурсы и подсказки из нескольких MCP-серверов, управляемых mcpd, в единый MCP-интерфейс, что облегчает IDE доступ ко всем возможностям без управления отдельными серверными соединениями.

Особенности

Унифицированный интерфейс: единый MCP-сервер, раскрывающий все возможности mcpd Агрегация инструментов: инструменты со всех серверов с server__tool соглашением об именах Агрегация ресурсов: ресурсы со всех серверов с server__resource именованием mcpd:// Ури

• Быстрая агрегация: Быстрая агрегация со всех серверов server__prompt Эффективное кэширование: использует кэширование SDK для проверки здоровья и схем инструментов Нулевая конфигурация: работает из коробки с разумными по умолчанию TypeScript: Построен с TypeScript для безопасности типа

Предпосылки

• Node.js 22.10.0 или выше (последний 22.x рекомендуется)
• npm 11.19.1 для разработки (версия, прикрепленная packageManager в package.json, см. Development Workflow)
• mcpd демон работает и доступен

mcpd-proxy

An MCP (Model Context Protocol) server that acts as a proxy between IDEs and the mcpd daemon, exposing all mcpd-managed MCP servers through a unified interface.

Overview

┌─────────────┐   STDIO/JSON-RPC    ┌──────────────┐    HTTP/REST     ┌──────────┐
│  IDE/Editor │ ◄─────────────────► │  mcpd-proxy  │ ◄───────────────►│   mcpd   │
│ (VS Code,   │     MCP Protocol    │  MCP Server  │   Uses mcpd SDK  │  daemon  │
│  Cursor)    │                     │              │                  │          │
└─────────────┘                     └──────────────┘                  └──────────┘

mcpd-proxy aggregates tools, resources, and prompts from multiple MCP servers managed by mcpd into a single MCP interface, making it easy for IDEs to access all capabilities without managing individual server connections.

Features

• Unified Interface: Single MCP server exposing all mcpd-managed capabilities
• Tool Aggregation: Tools from all servers with server__tool naming convention
• Resource Aggregation: Resources from all servers with server__resource naming and mcpd:// URIs
• Prompt Aggregation: Prompts from all servers with server__prompt naming convention
• Efficient Caching: Leverages SDK caching for health checks and tool schemas
• Zero Configuration: Works out of the box with sensible defaults
• TypeScript: Built with TypeScript for type safety

Prerequisites

• Node.js 22.10.0 or higher (latest 22.x recommended)
• npm 11.19.1 for development (the version pinned by packageManager in package.json, see Development Workflow)
• mcpd daemon running and accessible
• mcpd SDK (automatically installed as a dependency)

Installation

From npm (Recommended)

# Global installation
npm install -g @mozilla-ai/mcpd-proxy

# Or use directly with npx
npx @mozilla-ai/mcpd-proxy

From Source

# Clone the repository
git clone https://github.com/mozilla-ai/mcpd-proxy.git
cd mcpd-proxy

# Install dependencies
npm install

# Build the project
npm run build

Configuration

mcpd-proxy is configured via environment variables:

Usage

Running Directly

# Using npm package (recommended)
npx @mozilla-ai/mcpd-proxy

# With custom mcpd address
MCPD_ADDR=http://localhost:8090 npx @mozilla-ai/mcpd-proxy

# With API key
MCPD_ADDR=http://localhost:8090 MCPD_API_KEY=your-key npx @mozilla-ai/mcpd-proxy

# From source build
node dist/index.mjs

# From source with custom address
MCPD_ADDR=http://localhost:8090 node dist/index.mjs

VS Code Setup