Plexus MCP Server

关键词

模型上下文工具注册上下文代理会话管理上下文资源

使用说明（Markdown 格式）

  • 项目简介 Plexus 是一个面向多模型提供商的通用 API 网关与转换层，内置对 Model Context Protocol（MCP）的代理与路由能力，能够托管资源、注册并执行工具、渲染提示模板，并作为 MCP 服务器为 LLM 客户端提供标准化的上下文服务。

  • 主要功能点

    • MCP 协议处理与代理：接收 MCP 请求、生成响应，并通过 JSON-RPC/HTTP 与 MCP 客户端通信；支持会话隔离与能力声明。
    • 资源、工具与提示模板管理：提供对资源（Resources）、工具（Tools）和提示模板（Prompts）的注册、查询与渲染能力，便于 LLM 客户端在对话中调用外部功能与获取上下文信息。
    • MCP 代理与会话隔离：可代理外部 MCP 服务，确保不同客户端的会话相互隔离，提升安全性与可扩展性。
    • 会话管理与权限控制：内置会话生命周期、权限控制与审计，确保上下文数据的可控性与可追溯性。
    • 多传输与流式支持：理论上支持多种传输方式（如标准 JSON-RPC、流式传输等），以适配不同的 LLM 客户端需求。
    • 后端与前端整合：在后端实现 MCP 路由与管理接口，同时通过前端展示配置与监控能力（如 MCP 相关配置页面）。

  • 安装步骤

    • 克隆仓库后进入项目根目录，使用 Bun 作为执行环境。
    • 安装依赖：在根目录执行安装命令，确保后端与前端依赖就绪。
    • 启动开发环境（前后端联动）：在仓库根目录执行相应脚本（如启动 dev 堆栈的命令），等待后端服务器就绪。

  • 服务器配置（MCP 客户端使用的配置，供启动与连接 MCP 服务器参考） 说明：MCP 客户端需提供一个 JSON 配置，包含要连接的 MCP 服务器名称、启动命令及参数。以下为示例字段及释义，实际名称与参数可能随实现调整，请按具体客户端实现文档配置。 { "serverName": "plexus-mcp-proxy", "command": "bun", "args": [ "src/index.ts" ], "description": "Plexus MCP 代理服务器实例，用于对接 MCP 服务器并暴露给 MCP 客户端使用", "notes": "该配置用于 MCP 客户端启动时的最小信息集合，实际运行时可添加环境变量或额外参数以控制端口、上游 MCP 服务地址等。Upstream MCP 服务器地址由后端的配置文件管理。" }

  • 基本使用方法

    • 启动 MCP 服务端：在后端源码所在位置启动服务器（例如通过项目提供的开发脚本或 bun 直接运行入口），等待启动成功提示。
    • 配置 MCP 服务端（在后端进行）：通过后端管理接口创建与管理 MCP 服务器条目，配置 upstream_url、启动选项、请求头等。
    • 客户端接入：将上述客户端配置（serverName、command、args 等信息）放入 MCP 客户端配置中，连接 Plexus 提供的 MCP 服务入口，进行资源读取、工具调用与 Prompt 渲染等操作。
    • 运行与监控：通过后端提供的管理端口查看 MCP 服务器状态、日志与性能指标，按需调整并扩展功能。

服务器信息

访问项目