mozilla-ai/mcpd-proxy

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

21 stars 2 forks 품질 84 트렌드 30Apache-2.0

Repository Install

mcpd proxy MCP server for IDE integrations

개요

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. 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. - Unified Interface: Single MCP server exposing all mcpd-managed capabilities - Tool Aggregation: Tools 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 - Node.js 22.10.0 or higher (latest 22.x recommended) - npm 11.19.1 for development (the version pinned by packageManager in package.

README

원문 README의 일부입니다. 원문 보기.

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:

Variable	Description	Default
`MCPD_ADDR`	`mcpd` daemon address	`http://localhost:8090`
`MCPD_API_KEY`	Optional API key for `mcpd` authentication	(not set)

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

GitHub에서 전체 README 보기

설치

npx @mozilla-ai/mcpd-proxy

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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