已连接-mcp代理服务器

Name: 已连接-mcp代理服务器
Author: VeriTeknik

作者：VeriTeknik108 星标更新：2025-11-11

安装使用来源：spider==github.com

项目介绍

plugged.in MCP Hub — Proxy · Knowledge · Memory · Tools

<div align="center"> <img src="https://gips0.baidu.com/it/u=1914637397,2744006634&fm=3081&app=3081&f=PNG?w=256&h=64" alt="plugged.in Logo" width="256" height="75"> <h3>AI 数据交换的十字路口</h3> <p>一个统一的MCP中心，赋予您的AI <strong>知识</strong>、<strong>记忆</strong>和<strong>工具</strong>——而不仅仅是一个代理。通过单一连接管理并测试所有MCP服务器，同时在客户端之间提供文档感知和增强记忆的工作流程。</p>

</div>

📋 概述

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

此代理使与任何MCP客户端（Claude、Cline、Cursor等）无缝集成成为可能，同时通过plugged.in生态系统提供了高级管理能力。

中心支柱：知识·记忆·工具·代理

知识（RAG v2 / AI 文档交换）
搜索和定位模型输出，具有统一的、带有归属意识的文档检索。MCP服务器可以在您的库中创建和管理文档，包括版本控制、可见性控制和模型归属。使用内置的RAG跨所有连接源进行搜索，并返回相关片段和元数据。

记忆（持久AI记忆）
长期存在的、工作区/个人资料范围内的记忆，可以跨越会话。该中心与plugged.in应用的持久记忆集成，使得代理操作和见解可以在任务之间存储和回忆。内置的记忆工具正在路线图上，以在相同的认证模型下暴露低摩擦的get/put/search模式。

工具
聚合内置功能与下游MCP服务器(STDIO、SSE、可流式传输HTTP)。工具发现被缓存并且可以根据需要刷新；中心级别的发现返回任何MCP客户端的统一目录。中心支持工具、资源、资源模板和提示。

代理
每个客户端一个连接。作为STDIO（默认）或可流式传输HTTP运行，可选API认证和无状态模式。适用于Claude桌面版、Cline、Cursor、MCP检查器等；保持现有的客户端配置，同时集中策略和遥测。

⭐ 如果您觉得这个项目有用，请考虑在GitHub上给它一个星！ 这有助于我们接触到更多的开发者，并激励我们不断改进。

✨ 关键特性

🚀 核心能力

内置AI游乐场：无需任何客户端设置即可即时测试您的MCPs，包括Claude、Gemini、OpenAI和xAI。
通用MCP兼容性：与任何MCP客户端兼容，包括Claude桌面版、Cline和Cursor。
多服务器支持：连接到STDIO、SSE和可流式传输HTTP MCP服务器。
双传输模式：作为STDIO（默认）或可流式传输HTTP服务器运行代理。
统一文档搜索：使用内置RAG功能跨所有连接服务器进行搜索。
AI文档交换（RAG v2）：MCP服务器可以在您的库中创建和管理文档，具有完整的归属。
来自任何模型的通知：接收实时通知，可选电子邮件发送。
多工作区层：单击切换不同的MCP配置集。
API驱动的代理：从plugged.in应用API获取功能，而不是直接发现。
全面的MCP支持：处理工具、资源、资源模板和提示。
自定义指令：支持格式化为MCP提示的服务器特定指令。

🎯 v1.5.0 新特性（RAG v2 - AI 文档交换）

AI文档创建：MCP服务器现在可以直接在您的库中创建文档。
- 完整的模型归属跟踪（哪个AI创建/更新了文档）
- 带有变更跟踪的版本历史
- 通过SHA-256哈希进行内容去重
- 支持多种格式：MD、TXT、JSON、HTML、PDF等
高级文档搜索：增强的RAG查询带有AI过滤
- 按AI模型、提供商、日期范围、标签和来源类型过滤
- 带相关性评分的语义搜索
- 自动生成带关键词高亮的摘录
- 支持过滤：ai_generated、upload或api来源
通过MCP管理文档：
- 设置文档可见性：私有、工作区或公共
- 文档版本的父子关系
- 基于个人资料的组织以及基于项目的范围
- 实时进度跟踪文档处理

🎯 v1.4.0 特性（Registry v2 支持）

OAuth令牌管理：无缝处理Streamable HTTP MCP服务器的OAuth认证
- 从plugged.in应用自动检索令牌
- 安全的令牌存储和刷新机制
- 不需要客户端认证
增强的通知系统：双向通知支持
- 向plugged.in应用发送通知
- 接收来自MCP服务器的通知
- 将通知标记为已读/未读
- 程序化删除通知
趋势分析：实时活动跟踪
- 记录并跟踪每次工具调用
- 贡献于热门服务器计算
- 使用指标和受欢迎程度洞察
注册表集成：完全支持注册表v2功能
- 从注册表自动发现服务器
- 安装跟踪和指标
- 社区服务器支持

📦 v1.1.0 特性

可流式传输HTTP支持：完全支持使用可流式传输HTTP传输的下游MCP服务器。
HTTP服务器模式：作为HTTP服务器运行代理，具有可配置的端口。
灵活的身份验证：HTTP端点的可选Bearer令牌身份验证。
会话管理：选择有状态（基于会话）或无状态操作模式。

🎯 v1.0.0 核心特性

实时通知：通过全面的通知支持跟踪所有MCP活动。
RAG集成：通过plugged.in应用支持文档增强查询。
检查器脚本：用于调试和开发的自动化测试工具。
健康监控：内置ping端点用于连接监控。

🔧 工具类别

代理提供两类不同的工具：

🔧 静态内置工具（始终可用）

这些工具内置在代理中，无需任何服务器配置即可工作：

pluggedin_discover_tools - 带缓存的智能发现，即时结果
pluggedin_rag_query - RAG v2跨文档搜索，带有AI过滤能力
pluggedin_send_notification - 发送通知，可选电子邮件发送
pluggedin_create_document - （即将推出）在您的库中创建AI生成的文档

⚡ 动态MCP工具（来自连接的服务器）

这些工具来自您配置的MCP服务器，可以开启或关闭：

数据库工具（PostgreSQL、SQLite等）
文件系统工具
API集成工具
来自任何MCP服务器的自定义工具

发现工具智能显示这两类工具，使AI模型立即访问所有可用功能。

🚀 发现工具用法

# 快速发现 - 即刻返回缓存的数据
pluggedin_discover_tools()

# 强制刷新 - 显示当前工具 + 后台发现
pluggedin_discover_tools({"force_refresh": true})

# 发现特定服务器
pluggedin_discover_tools({"server_uuid": "uuid-here"})

示例响应：

## 🔧 静态内置工具（始终可用）：
1. **pluggedin_discover_tools** - 带缓存的智能发现
2. **pluggedin_rag_query** - RAG v2跨文档搜索，带有AI过滤
3. **pluggedin_send_notification** - 发送通知
4. **pluggedin_create_document** - （即将推出）在您的库中创建AI生成的文档

## ⚡ 动态M-CP工具（8） - 来自连接的服务器：
1. **query** - 运行只读SQL查询
2. **generate_random_integer** - 生成安全随机整数
...

📚 RAG v2 使用示例

增强的RAG v2系统允许MCP服务器创建和搜索文档，具有完整的AI归属：

# 搜索由特定AI模型创建的文档
pluggedin_rag_query({
  "query": "系统架构",
  "filters": {
    "modelName": "Claude 3 Opus",
    "source": "ai_generated",
    "tags": ["技术"]
  }
})

# 跨所有文档来源搜索
pluggedin_rag_query({
  "query": "部署指南",
  "filters": {
    "dateFrom": "2024-01-01",
    "visibility": "工作区"
  }
})

# 未来：创建AI生成的文档（即将推出）
pluggedin_create_document({
  "title": "分析报告",
  "content": "# 市场分析\n\n详细发现...",
  "format": "md",
  "tags": ["分析", "市场"],
  "metadata": {
    "model": {
      "name": "Claude 3 Opus",
      "provider": "Anthropic"
    }
  }
})

🚀 快速开始

先决条件

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

安装

# 使用npx安装并运行最新版本v1.0.0
npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

🔄 升级至v1.0.0

对于现有安装，请参阅我们的Migration Guide以获取详细的升级说明。

# 快速升级
npx -y @pluggedin/pluggedin-mcp-proxy@1.0.0 --pluggedin-api-key YOUR_API_KEY

MCP客户端配置

Claude Desktop

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

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

Cline

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

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

Cursor

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

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

⚙️ 配置选项

环境变量

变量	描述	是否必需	默认值
`PLUGGEDIN_API_KEY`	plugged.in应用的API密钥	是	-
`PLUGGEDIN_API_BASE_URL`	plugged.in应用的基础URL	否	`https://plugged.in`

命令行参数

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

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

传输选项

选项	描述	默认值
`--transport <type>`	传输类型：`stdio` 或 `streamable-http`	`stdio`
`--port <number>`	Streamable HTTP服务器的端口	`12006`
`--stateless`	启用Streamable HTTP的无状态模式	`false`
`--require-api-auth`	要求Streamable HTTP请求的API密钥	`false`

要查看所有选项：

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

🌐 可流式传输HTTP模式

代理可以作为HTTP服务器而不是STDIO运行，从而实现基于web的访问和远程连接。

基本用法

# 在默认端口（12006）上作为HTTP服务器运行
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --pluggedin-api-key YOUR_API_KEY

# 自定义端口
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --port 8080 --pluggedin-api-key YOUR_API_KEY

# 需要认证
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --require-api-auth --pluggedin-api-key YOUR_API_KEY

# 无状态模式（每次请求新会话）
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --stateless --pluggedin-api-key YOUR_API_KEY

HTTP端点

POST /mcp - 发送MCP消息
GET /mcp - 服务器发送事件流（可选）
DELETE /mcp - 终止会话
GET /health - 健康检查端点

会话管理

在有状态模式（默认）下，使用mcp-session-id头来维护会话：

# 第一次请求创建会话
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# 后续请求使用相同的会话
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type:  application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: YOUR_SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"tool_name"},"id":2}'

认证

当使用--require-api-auth时，将您的API密钥作为Bearer令牌包含：

curl -X POST http://localhost:12006/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"ping","id":1}'

🐳 Docker 使用

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

构建镜像

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

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

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

运行容器

STDIO模式（默认）

在STDIO模式下运行容器以进行MCP检查器测试：

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

可流式传输HTTP模式

作为HTTP服务器运行容器：

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

替换YOUR_API_KEY和YOUR_API_BASE_URL（如果未使用默认的`https://plugged.in