plugged.in MCP 代理服务器使用说明

项目简介

plugged.in MCP 代理服务器是一个强大的中间件，旨在将多个 Model Context Protocol (MCP) 服务器聚合到一个统一的接口中。它通过 plugged.in 平台管理工具、Prompt 和资源配置，并智能地将请求路由到适当的底层 MCP 服务器。该代理服务器支持任何 MCP 客户端（如 Claude、Cline、Cursor 等），并通过内置的 AI 游乐场、RAG 功能、通知系统和文档管理功能，提供高级的上下文管理能力。

主要功能点

统一接口: 将多个 MCP 服务器聚合为一个单一的访问点，简化 LLM 客户端的连接和管理。
多传输协议支持: 能够连接到使用 STDIO、SSE 和 Streamable HTTP 协议的各种下游 MCP 服务器。
双运行模式: 代理服务器自身可以作为 STDIO（标准输入/输出）或 Streamable HTTP 服务器运行，灵活适应不同的部署环境。
内置 AI 游乐场: 提供一个测试环境，无需额外客户端设置即可即时测试 MCP 功能，支持 Claude、Gemini、OpenAI 和 xAI 等多种 AI 模型。
统一文档搜索 (RAG v2): 支持跨所有连接服务器的文档进行检索增强生成 (RAG) 查询，并具备 AI 文档创建、归因和版本管理能力。
通知系统: 允许接收实时活动通知，并支持发送自定义通知（可选电子邮件递送）。
完整的 MCP 支持: 全面处理 MCP 协议定义的工具 (Tools)、资源 (Resources)、资源模板 (Resource Templates) 和 Prompt 模板 (Prompts)。
自定义指令: 支持服务器特定的定制指令，这些指令会以 MCP Prompt 的形式提供给 LLM，实现更精细的控制。

安装步骤

前提条件: 确保您的系统已安装 Node.js 18+ 版本 (推荐 v20+)。
获取 API 密钥: 访问 plugged.in/api-keys 注册并获取您的 plugged.in API 密钥。

通过 npx 安装并运行: 在终端中运行以下命令，将 'YOUR_API_KEY' 替换为您的实际 API 密钥：

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

或者使用 Docker 运行 (以 Streamable HTTP 模式为例):

docker run -d --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -p 12006:12006 \
  --name pluggedin-mcp-http \
  pluggedin-mcp-proxy:latest \
  --transport streamable-http --port 12006

请注意，'YOUR_API_KEY' 必须是您从 plugged.in 获取的有效密钥。

服务器配置 (MCP 客户端使用)

MCP 客户端（如 Claude Desktop 或 Cline）需要配置启动命令来连接 plugged.in MCP 代理服务器。以下是配置 MCP 客户端时所需信息的说明：

'server name' (服务器名称): 为您的 MCP 客户端指定一个易于识别的名称，例如 "pluggedin"。
'command' (启动命令): 代理服务器的启动命令，通常是 'npx'，因为它通过 npm 包管理器运行。
'args' (参数): 传递给 'command' 的参数，用于指定要执行的代理服务器包及其版本，例如 '["-y", "@pluggedin/pluggedin-mcp-proxy@latest"]'。
'env' (环境变量): 包含您的 'PLUGGEDIN_API_KEY'，这是代理服务器与 plugged.in 平台进行身份验证所必需的。

Claude Desktop 配置示例: 在您的 Claude Desktop 配置文件（通常是 'config.json' 或类似文件）中，您可以添加如下配置结构：

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

请将 'YOUR_API_KEY' 替换为您从 plugged.in 获取的实际 API 密钥。此配置使得 Claude Desktop 能够通过执行 'npx @pluggedin/pluggedin-mcp-proxy@latest' 命令并传递指定的环境变量来启动并连接到 plugged.in MCP 代理服务器。

基本使用方法

启动代理服务器: 首先，按照上述“安装步骤”中的指示，在您的本地机器上启动 plugged.in MCP 代理服务器。
连接 MCP 客户端: 配置您的 MCP 客户端（例如 Claude Desktop 或 Cline）以连接到此代理服务器。参考上面的“服务器配置”部分。
发现功能: 在您的 MCP 客户端中，调用 'pluggedin_discover_tools()' 工具。这将列出所有通过 plugged.in 平台连接的 MCP 服务器所提供的工具、资源和 Prompt。
使用工具: 发现工具后，您可以通过其唯一的、前缀化的名称在 MCP 客户端中调用它们。工具名称的格式通常为 '服务器UUID__原始工具名称'（例如 '550e8400-e29b-41d4-a716-446655440000__read_file'）。直接调用这些名称即可执行对应的下游 MCP 服务器功能。
利用内置功能: 您可以直接调用代理服务器提供的静态工具，例如：
- 'pluggedin_ask_knowledge_base({"query": "我的项目最新进展是什么？"})' 进行 RAG 查询。
- 'pluggedin_create_document({"title": "新功能分析", "content": "# 新功能详情..."})' 创建 AI 生成的文档。
- 'pluggedin_send_notification({"message": "AI分析报告已完成"})' 发送自定义通知。

关键词