Elisa MCP 后端服务器

使用说明内容（Markdown格式）

• 项目概述

  • Elisa 提供一个面向 LLM 的后端框架，核心能力包括托管与管理 Resources（资源数据、数据访问）、注册与执行 Tools（工具/功能）、定义与呈现 Prompts（提示模板），以及通过 MCP 机制与外部 MCP 服务器进行交互。服务器通过 JSON-RPC 或类似结构进行请求/响应通信，并支持多种传输方式（REST/WebSocket 等）以实现与前端、插件和外部系统的协同。

• 主要功能点

  • 资源与数据访问：后端提供资源管理，方便 LLM 客户端读取/写入可用数据。
  • 工具注册与执行：允许通过端点注册外部工具并在需要时触发调用。
  • Prompt 模板与渲染：提供对提示片段的集中管理与渲染能力，便于在对话中复用。
  • MCP 端口与集成：通过 Portal/Adapter 体系接入外部 MCP 服务器，支持 mcp/cli 等传输与适配方式。
  • 会话与能力声明：维护会话状态、能力边界、以及多种传输协议的支持。
  • JSON-RPC/协议抽象：后端对 MCP 请求/响应进行结构化处理，向前端客户端返回标准化的 JSON-RPC 风格响应。

• 安装步骤

  • 1. 确保 Node.js 版本与环境变量就绪（如 ANTROPIC_API_KEY/相关模型密钥）。
  • 2. 运行安装：在仓库根目录执行安装命令，安装 root、后端与前端依赖。
  • 3. 启动后端服务器：依据项目配置，可以使用开发命令直接启动 Express + WS 服务。
  • 4. 如需在浏览器或桌面端调试，请参照快速启动文档，确保后端端口与前端代理配置正确（如 /api、/ws 的转发到后端）。
  • 5. 如要连接外部 MCP 服务器：使用 Portal 模板在后端配置中创建 MCP Portal 条目，提供对应的启动命令与参数。

• 服务器配置（供 MCP 客户端连接使用的 JSON 配置示例说明） 说明：以下配置用于 MCP 客户端在启动阶段连接 MCP 服务器。包含服务器名称、启动命令及参数等信息。请以实际部署信息替换示例字段。MCP 客户端需要此信息来与服务器建立连接并进行后续通信。

  • server_name: Elisa MCP 后端服务器
  • command: node
  • args: 例如 ["dist/server.js"]，或 ["backend/dist/server.js"]，取决于构建产物路径 注释：该字段用于指示 MCP 客户端应如何启动并连接到 MCP 服务器。根据实际部署环境选择正确的入口文件和参数。客户端不需要对服务器内部实现细节进行配置。

• 基本使用方法

  • 启动与连接
    • 在本地开发环境，先启动后端服务器，确保 API、WebSocket、以及 MCP 相关路由就绪。
    • 使用 MCP 客户端连接时，提供 server_name、command、args 等必要信息以建立连接。
  • 功能使用
    • 通过 MCP 客户端查询资源、调用工具、获取并渲染 Prompt 模板，后端将以统一的接口返回 JSON-RPC 风格的响应。
  • 安全与扩展
    • 后端具备会话管理与能力声明，支持多传输协议，便于在不同的前端/设备/服务之间扩展。
  • 部署与运维
    • 可以将后端部署为桌面应用、容器或云服务，结合 Portal 模块实现对外部 MCP 服务器的动态扩展。

• 额外说明

  • 项目内已有完整的后端服务器代码（Express 5 + WebSocket），以及用于 MCP 端口、Portal 的适配器、模板和注册机制等，表明实现了面向 MCP 的服务器端能力与扩展点。
  • 客户端实现与服务器端实现共同构成一个可运行的 MCP 生态系统，具备资源/工具/提示模板的管理能力、以及对外部 MCP 服务器的接入能力。

• 注意事项

  • MCP 协议具体的 JSON-RPC 请求格式、错误码、以及端到端的序列化/反序列化实现，请以后端实现的实际接口为准。
  • 连接的安全性、鉴权与配额等策略在生产环境中需按照实际部署进行强化。