Sellf MCP 服务器（ Claude Desktop 版本）

关键词

模型上下文资源管理工具执行提示模板JSON-RPC

  • 使用说明内容（Markdown 格式）：

  • 项目简介 Sellf 的 MCP 服务器实现用于以标准化的 JSON-RPC 方式向 LLM 客户端暴露资源、工具和提示模板等上下文能力。服务器负责会话管理、能力声明，以及对多种传输协议的支持，便于 LLM 客户端在各类场景下获取一致的上下文和功能。

  • 主要功能点

    • 资源管理与数据访问：以标准化形式托管并提供对资源的读取、查询与权限控制。
    • 工具注册与执行：注册外部工具，LLM 客户端可通过 RPC 调用执行特定功能。
    • 提示模板定义与渲染：定义、管理并渲染用于与 LLM 的交互的 Prompt 模板。
    • JSON-RPC 协议实现：服务器端实现 MCP 的核心通信协议，接收请求并返回标准化响应。
    • 会话与能力声明：在会话范围内声明服务器能力与可用资源、工具、Prompt 等。
    • 多传输协议支持：如 STDIO、SSE、WebSocket 等传输方式，提升与不同前端/客户端的对接能力。
    • 安全与可扩展性：具备访问控制、日志、鉴权等机制，便于在多租户或多客户场景中扩展。

  • 安装步骤

    1. 将仓库克隆到本地/服务器。
    2. 进入 mcp-server 目录，安装依赖（如 npm i 或 bun install，视项目具体构建工具而定）。
    3. 按照 mcp-server/README.md 中的说明完成初始配置（资源、工具、Prompts 的定义位置、授权与密钥等）。
    4. 启动 MCP 服务器，确保日志输出正常，监听端口已开放，且可与 Claude Desktop 等客户端通信。
    5. 根据需要在 Claude Desktop 客户端进行 MCP 服务配置，确保服务器地址、端口和传输协议匹配。

  • 服务器配置（供 MCP 客户端使用的启动配置示例说明） 注：以下为配置思路描述，具体参数请以仓库 mcp-server 的文档为准。MCP 客户端需要提供启动命令及参数以便与 MCP 服务器建立连接。配置信息以 JSON 形式给出（字段含义保留解释性注释，实际参数按客户端需求填写）。 服务器配置示例（JSON 格式描述）: { "server_name": "sellf-mcp-server", "command": "node", "args": [ "dist/server.js", "--port", "4242", "--transport", "stdio,sse,websocket" ], "description": "MCP 服务器启动信息，包含可用传输协议，端口及入口脚本路径，实际路径以仓库文档为准" } 说明：

    • server_name：服务器唯一标识名称，便于在客户端配置中引用。
    • command：启动服务器的可执行程序，例如 node、bun 等，依据实际实现选择。
    • args：传给启动程序的参数，常见包括入口脚本、端口、传输协议等。
    • 注：实际命令、参数和入口文件路径请参考 mcp-server 子目录的 README/doc，确保与 Claude Desktop 客户端的对接信息一致。

  • 基本使用方法

    • 启动与连接
      • 按照服务器文档启动 MCP 服务，确保监听端口可访问。
      • 在 Claude Desktop（或任意支持 MCP 的客户端）中使用上述 JSON 配置连接到 MCP 服务器，确保传输协议与服务器端实现匹配。
    • 资源、工具、Prompts 的使用
      • 客户端通过 JSON-RPC 请求读取资源、读取工具清单、调用工具、获取和渲染 Prompt 模板。
    • 会话与安全
      • 服务器维护会话状态与能力声明，结合鉴权机制确保安全访问。
    • 日志与调试
      • 启动后检查控制台/日志输出，确保请求得到正确的 JSON-RPC 响应，如遇错误根据文档定位问题。

  • 注意事项

    • MCP 服务器实现需要与 Claude Desktop（或其他 MCP 客户端）保持协议版本的一致性，及时同步 API/协议变更。
    • 部署环境要保证网络通达、跨进程通信安全，以及对多传输协议的正确配置。

服务器信息

访问项目