使用说明

• 项目简介

  • Plasmite 提供一个实现 MCP 协议的后端服务器，用于托管和管理资源（Resources）、注册与执行工具（Tools），并定义/渲染提示模板（Prompts），以标准化的 JSON-RPC 形式对外提供上下文服务，帮助 LLM 客户端安全、高效地访问数据和外部能力。

• 主要功能点

  • 资源管理：托管、查询和访问资源数据，方便 LLM 客户端按需获取上下文数据。
  • 工具注册与执行：注册外部功能入口，允许 LLM 客户端通过统一接口调用外部工具实现扩展能力。
  • 提示模板（Prompts）支持：定义和渲染用于 LLM 交互的提示模板，提供可定制的对话风格与上下文传递。
  • JSON-RPC 通信：服务器端通过 /mcp 路径实现 MCP 的核心请求/响应及通知传递。
  • 会话与能力声明：服务器端维护会话、权限和能力声明，确保对不同客户端的访问控制与能力描述准确。
  • 多传输协议支持：提供本地 STDIO、SSE、WebSocket 等传输模式，以适配不同部署和集成场景。
  • 简易 UI 与远程访问：内置最小化 UI 界面，支持远程客户端查看与交互。

• 安装步骤

  • 编译与安装
    • 使用项目提供的多语言绑定与 CLI 工具来构建和运行 MCP 服务器（Plasmite）；
    • 也可以使用仓库的预构建二进制在对应平台直接运行；
  • 依赖与准备
    • 需要 Rust/Go/Node/Python 等绑定的运行环境（具体绑定实现见仓库相应目录）；
    • 需要可用的编译工具链与依赖（如 cargo、npm、pip、go 等，按对应绑定选择执行）。
  • 启动服务器
    • 通过 CLI 启动服务器，例如 plasmite serve，指定数据池目录、绑定地址等参数；
    • 如需远程访问，可配置跨域、令牌等安全参数，服务器会提供 /mcp API 与 UI。

• 服务器配置（示例，JSON 描述）

  • server_name: plasmi te-mcp-http
  • command: plasmite
  • args: ["serve", "--dir", "/var/plasmite/pools", "--bind", "127.0.0.1:9700"] 说明：以上示例配置用于启动一个 MCP 服务端实例。客户端在连接时需要知道服务器的启动命令与参数，以便正确启动并连接到 MCP 服务。实际部署时请将路径和端口替换为你的环境配置。若需要鉴权，可在 args 中添加 --token <token>、--token-file <path> 等参数，具体保持与仓库实现的安全选项一致。服务端将提供 /mcp JSON-RPC 接口供 MCP 客户端调用。

• 基本使用方法

  • 启动服务端
    • 使用上述配置的命令启动服务器，确保服务绑定地址可达。
  • 连接与交互
    • MCP 客户端通过 /mcp 路径对服务器发起 JSON-RPC 请求，进行资源查询、工具调用和读取推送等操作。
  • 监控与 UI
    • 服务器提供内置 UI 路由，访问 http://<服务器地址>/ui 查看资源、 pools、以及事件流等信息。
  • 安全与权限
    • 根据需要开启令牌认证、跨域策略等安全特性，确保 MCP 客户端的调用权限与数据访问范围符合预期。