plugged.in MCP 代理服务器

📋 概述

plugged.in MCP 代理服务器是一个强大的中间件，它将多个机器对话协议（MCP）服务器聚合到一个统一的接口中。它从 plugged.in 应用程序 获取工具、提示和资源配置，并智能地将请求路由到适当的底层 MCP 服务器。

该代理使任何 MCP 客户端（如 Claude、Cline、Cursor 等）能够无缝集成，同时通过 plugged.in 生态系统提供高级管理功能。

✨ 主要特性

• 通用 MCP 兼容性：与任何 MCP 客户端兼容，包括 Claude Desktop、Cline 和 Cursor
• 多服务器支持：连接 STDIO（命令行）和 WebSocket（基于 HTTP 的）MCP 服务器
• 命名空间隔离：通过适当的前缀保持加入的 MCP 分离并组织好
• 多工作区层：一键切换不同的 MCP 配置集
• 简化架构：代码库更加简洁，启动时间更快，复杂度降低
• API 驱动的代理：从 plugged.in 应用程序 API 获取能力而不是直接发现
• 完整的 MCP 支持：处理工具、资源、资源模板和提示
• 自定义指令：支持格式为 MCP 提示的特定服务器指令

🚀 快速开始

前提条件

• Node.js 18+（推荐 v20+）
• 来自 plugged.in 应用程序的 API 密钥（在 plugged.in/api-keys 获取）

安装

# Install and run with npx
npx -y @pluggedin/mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

MCP 客户端配置

Claude Desktop

在您的 Claude Desktop 配置中添加以下内容：

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cline

在您的 Cline 配置中添加以下内容：

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

对于 Cursor，您可以使用命令行参数而不是环境变量：

npx -y @pluggedin/mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

⚙️ 配置选项

环境变量

命令行参数

命令行参数优先于环境变量：

npx -y @pluggedin/mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY --pluggedin-api-base-url https://your-custom-url.com

完整的选项列表：

npx -y @pluggedin/mcp-proxy@latest --help

🐳 Docker 使用

您也可以使用 Docker 构建和运行代理服务器。

构建镜像

确保已安装并运行 Docker。导航到 pluggedin-mcp 目录并运行：

docker build -t pluggedin-mcp-proxy:latest .

包含了一个 .dockerignore 文件以优化构建上下文。

运行容器

运行容器，并提供必要的环境变量：

docker run -it --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \
  --name pluggedin-mcp-container \
  pluggedin-mcp-proxy:latest

替换 YOUR_API_KEY 和 YOUR_API_BASE_URL（如果不使用默认的 https://plugged.in）。

使用 MCP Inspector 测试

在容器运行时，您可以使用 MCP Inspector 连接到它：

npx @modelcontextprotocol/inspector docker://pluggedin-mcp-container

这将连接到正在运行的容器的标准输入/输出。

停止容器

在执行 docker run 的终端中按 Ctrl+C。--rm 标志确保在停止时自动删除容器。

🏗️ 系统架构

plugged.in MCP 代理服务器作为 MCP 客户端与多个底层 MCP 服务器之间的桥梁：

sequenceDiagram
    participant MCPClient as MCP Client (e.g. Claude Desktop)
    participant PluggedinMCP as plugged.in MCP Proxy
    participant PluggedinApp as plugged.in App
    participant MCPServers as Underlying MCP Servers

    MCPClient ->> PluggedinMCP: Request list tools/resources/prompts
    PluggedinMCP ->> PluggedinApp: Get capabilities via API
    PluggedinApp ->> PluggedinMCP: Return capabilities (prefixed)

    MCPClient ->> PluggedinMCP: Call tool/read resource/get prompt
    alt Standard capability
        PluggedinMCP ->> PluggedinApp: Resolve capability to server
        PluggedinApp ->> PluggedinMCP: Return server details
        PluggedinMCP ->> MCPServers: Forward request to target server
        MCPServers ->> PluggedinMCP: Return response
    else Custom instruction
        PluggedinMCP ->> PluggedinApp: Get custom instruction
        PluggedinApp ->> PluggedinMCP: Return formatted messages
    end
    PluggedinMCP ->> MCPClient: Return response

    alt Discovery tool
        MCPClient ->> PluggedinMCP: Call pluggedin_discover_tools
        PluggedinMCP ->> PluggedinApp: Trigger discovery action
        PluggedinApp ->> MCPServers: Connect and discover capabilities
        MCPServers ->> PluggedinApp: Return capabilities
        PluggedinApp ->> PluggedinMCP: Confirm discovery complete
        PluggedinMCP ->> MCPClient: Return discovery result
    end

🔄 工作流程

1. 配置：代理从 plugged.in 应用程序获取服务器配置
2. 功能列表：代理从 plugged.in 应用程序 API 获取发现的功能
   • tools/list：从 /api/tools 获取（返回带前缀的名称）
   • resources/list：从 /api/resources 获取
   • resource-templates/list：从 /api/resource-templates 获取
   • prompts/list：从 /api/prompts 和 /api/custom-instructions 获取，合并结果
3. 功能解析：代理解析功能到目标服务器
   • tools/call：从工具名称中解析前缀，在内部映射中查找服务器
   • resources/read：调用 /api/resolve/resource?uri=... 获取服务器详情
   • prompts/get：检查自定义指令前缀或调用 /api/resolve/prompt?name=...
4. 请求路由：请求被路由到适当的底层 MCP 服务器
5. 响应处理：来自底层服务器的响应返回给客户端

🧩 与 plugged.in 应用集成

plugged.in MCP 代理服务器旨在与 plugged.in 应用无缝协作，该应用提供：

• 用于管理 MCP 服务器配置的基于 Web 的界面
• 集中的功能发现（工具、资源、模板、提示）
• 自定义指令管理
• 支持多工作区的不同配置集
• 用于测试 MCP 工具的交互式游乐场
• 用户认证和 API 密钥管理

📚 相关资源

• plugged.in 应用仓库
• 机器对话协议 (MCP) 规范
• Claude 桌面文档
• Cline 文档

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目根据 MIT 许可证许可 - 详情请参见 LICENSE 文件。

🙏 致谢

• 受 MCP Proxy Server 启发
• 基于 Machine Conversation Protocol 构建