mozilla-ai/mcpd-proxy

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

21 stars 2 forks 质量 84 趋势 30Apache-2.0

Repository Install

mcpd 代理 MCP 服务器用于 IDE 集成

概览

一个MCP（模型上下文协议）服务器，作为IDE与mcpd守护进程之间的代理，通过统一接口暴露所有mcpd管理的MCP服务器。 mcpd-proxy 将由 mcpd 管理的多台 MCP 服务器上的工具、资源和提示聚合到单一 MCP 接口中，使 IDE 能够轻松访问所有功能，而无需管理单个服务器连接。 - 统一接口：单一MCP服务器，暴露所有mcpd管理功能 - 工具聚合：所有服务器的工具，具server__resource命名和 mcpd:// URI - 提示词聚合：所有具有server__prompt命名规范的服务器提示 - 高效缓存：利用SDK缓存进行健康检查和工具模式 - 零配置：开箱即用且默认设置合理 - TypeScript：基于TypeScript构建类型安全 - Node.js 22.10.0 或更高版本（推荐最新 22.x）- 开发用 NPM 11.19.1（由 packageManager 在包中钉定的版本）。

概述（AI 翻译）

一个MCP（模型上下文协议）服务器，作为IDE与mcpd守护进程之间的代理，通过统一接口暴露所有mcpd管理的MCP服务器。

概述

mcpd-proxy 将由 mcpd 管理的多个 MCP 服务器的工具、资源和提示汇聚到单一 MCP 界面，使 IDE 能够轻松访问所有功能，而无需管理单个服务器连接。

特色

统一接口：单一MCP服务器，暴露所有mcpd管理能力
工具聚合：所有具有server__tool命名规范的服务器工具
资源聚合：所有以server__resource命名和mcpd://为URI的服务器资源
提示聚合：所有具有server__prompt命名规则的服务器的提示
高效缓存：利用SDK缓存进行健康检查和工具模式
零配置：开箱即用，默认值合理
TypeScript：采用TypeScript构建以实现类型安全

先修条件

Node.js 22.10.0 或更高版本（推荐最新 22.x）
npm 11.19.1 用于开发（由 packageManager 钉顶的版本，见开发工作流程）
mcpd 守护进程运行且可访问

本页由 AI 翻译，技术细节请以原文为准。

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

新手？先看 mcpskill.org 教程 →

配置

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