EasyBits MCP Server

使用说明（Markdown 格式）

• 项目简介
  • 该仓库实现了一个完整的 MCP 服务器，能够托管资源、注册并执行工具、以及渲染/提供 Prompt 模板。服务器通过 JSON-RPC 与 LLM 客户端交互，核心逻辑包括资源和工具的注册、操作，以及对外暴露的接口。还提供了基于 WebStandard 的传输实现，方便与不同客户端的连接。
• 主要功能点
  • MCP 核心能力：支持按 MCP 规范处理请求与响应（资源、工具、Prompts 的管理与执行），并通过 JSON-RPC 与客户端通信。
  • 资源管理：通过 MCP App Resource 提供 UI 组件与后端接口，用于文件、网站等资源的读取、列举、上传、删除等操作。
  • 工具注册与执行：通过 registerAppTool 注册多种工具（如 list_files、get_file、upload_file、delete_file、update_file、share_file 等），支持参数校验与结果回传。
  • Prompts 定义与渲染：支持自定义提示模板以影响 LLM 的交互模式。
  • 会话与权限：具备会话管理、能力声明，以及基于 Bearer Token 的身份验证与权限检查。
  • 多传输支持（可扩展）：当前实现通过 Web 投送传输（WebStandardStreamableHTTPServerTransport）实现 MCP 的请求/响应，便于与你的客户端的集成，理论上可扩展到 Stdio、SSE、WebSocket 等传输。
  • 完整的服务端代码结构：包含 MCP 服务核心、路由/处理、资源与工具实现、以及与数据库、存储、Webhook、Stripe 等模块的集成。
• 安装与运行步骤
  • 安装依赖、生成 Prisma 客户端，并启动开发服务器（参见 README 的常规流程）：
    • prisma 相关生成
    • 启动开发环境
  • 运行示例（仓库中给出的入口命令之一）：
    • npx -y @easybits.cloud/mcp
• 服务器配置（MCP 客户端使用的配置示例） 注：下面的配置用于 MCP 客户端对接该 MCP 服务器的起动参数，包含服务器名称、启动命令以及参数。客户端需要此信息来建立与 MCP 服务器的连接；具体连接地址、鉴权方式由客户端实现方决定。 { "serverName": "EasyBits MCP Server", "command": "npx", "args": ["-y", "@easybits.cloud/mcp"], "description": "启动 EasyBits 的 MCP 服务器，用于向 LLM 客户端提供资源、工具与提示模板等上下文能力" }
• 基本使用方法
  • 启动服务器后，LLM 客户端通过 MCP 的标准接口（JSON-RPC）向服务器请求资源、执行工具、获取/渲染 Prompts 等。
  • 客户端可通过注册的工具调用服务器端的具体实现，如列出文件、获取文件、上传文件、共享权限等，服务器返回 MCP 定义的标准 JSON-RPC 响应。
  • 服务器端负责会话管理、能力声明以及对请求的鉴权与速率限制，确保服务的安全性与稳定性。