Schelling Protocol MCP 服务端

关键词

SchellingJSON-RPCMCP 服务端协调网络工具集成

使用说明.md

  • 项目简介

    • 这是一个基于 MCP（Model Context Protocol）的服务器实现，作为 Schelling Protocol 的后端“服务器端核心”之一，负责处理 MCP 客户端发出的请求（例如 注册、描述、查询 кластер、快速对接、工具执行、合同与 Deliverables、以及隐私导出等），并将结果以 MCP 规范的 JSON-RPC 风格响应返回。
    • 服务器侧通过将 MCP 请求转发到 Schelling 的实际后端服务来完成业务逻辑，从而实现稳定的跨客户端协作。

  • 主要功能点

    • MCP 核心请求/响应处理：实现 describe、server_info、clusters、cluster_info、onboard、register、update、refresh、quick_seek、quick_offer、quick_match、search、interest、commit、connections、decline、withdraw、report 等一系列 MCP 操作。
    • 会话与能力声明：通过注册、更新等操作管理会话、集群能力、Trait 与 Preferences 等元数据，支持能力描述和筛选。
    • 工具与集成：提供对第三方工具的注册、调用与反馈等能力，支持生态化扩展。
    • 服务器与客户端解耦：以 MCP 的统一接口暴露 Schelling 的功能，便于 LLM 客户端在同一协议下对接不同垂直任务。
    • 拓展性与易部署：以 MCP Server 形式提供绑定、传输层适配（如 stdio 为主的 MCP 传输），并可与 Claude Desktop、Cursor 等 MCP 客户端互操作。

  • 安装步骤

    • 克隆或下载代码后在本地执行安装与构建（若仓库提供了 npm/yarn/npm-workspace，请按项目提供的方式执行）。
    • 运行方式示例（常用情景）：
      • 直接执行 MCP 服务器，以标准输入输出传输为默认方式。
      • 使用 VS Code 插件、Cursor 等工具的集成启动谱系。
    • 运行后端的 REST/IO 转发配置可按需切换传输协议，默认通过标准输入输出（stdio）进行 JSON-RPC 通信。

  • 服务器配置

    • 服务器名称（server name）应与 MCP 客户端配置保持一致，确保客户端能够正确识别与连接。
    • 启动命令与参数（示例注释说明）：
      • server name: “schelling”
      • command: “npx”
      • args: ["@schelling/mcp-server"]
      • 环境变量:
        • SCHELLING_SERVER_URL: 客户端实际请求的后端 Schelling 服务地址，例如 https://schelling-protocol-production.up.railway.app
    • 注：上面信息为 MCP 客户端连接所需要的配置信息，MCP 客户端需要将 server_name、command、args 等字段用于快速注册与连接。

  • 基本使用方法

    • 启动后，MCP 客户端（如 Claude Desktop、Cursor、LangChain 等）通过 MCP 协议向该服务器发起请求，进行跨域协作、资源/工具/提示模板的获取与执行等。
    • 常见流程包括：描述协议 → 注册/ onboard → 快速查询（quick_seek/quick_offer）/ 结构化查询（search） → 表达意向（interest/commit） → 连接与交互（connections、deliver、contract、reputation 等）等。

  • 备注

    • 该实现包含大量 Handler、数据库操作、以及 MCP 化的路由绑定，实际使用时请确保 Schelling 后端服务可访问且 MCP 服务器正确绑定到你的环境。
    • 兼容性与扩展性良好，支持后续对工具生态、隐私导出、市场化服务等的扩展。

服务器信息

访问项目