JFL Context MCP 服务器套件

关键词

上下文管理JSON-RPC工具执行Context Hub会话协作

使用说明（Markdown 摘要）

  • 项目简介

    • 本仓库实现了一组基于 MCP 的服务器端组件，核心职责是向 LLM 客户端提供上下文资源、可注册执行的工具以及可渲染的 Prompt 模板。通过 JSON-RPC 与客户端通信，服务器端负责会话管理、能力声明，以及与 Context Hub 的对接。
    • 主要目标是为 AI-native 团队提供一个可扩展、可组合的上下文服务框架，以便在多 GM/GT M/Service 场景中共享上下文、执行工具、并定义统一的对话模板。

  • 主要功能点

    • 处理 MCP 请求与响应：实现 MCP 的核心请求/响应路径，支持 initialize、tools/list、tools/call 等常用方法，并返回符合 MCP 规范的 JSON-RPC 响应。
    • 工具与服务注册：暴露“工具（Tools）”集合，支持标准工具（如 context_get、context_search、memory_search 等）以及服务自定义工具，供 LLM 调用。
    • 资源与上下文渲染：提供对资源和上下文的访问接口，结合 Context Hub 实现统一的上下文查询和合成能力。
    • 会话与交互协作：提供会话级别的状态与协作能力（如与 Context Hub 的会话、跨 GTM/服务的事件桥接），支持多进程/多工作区的协作场景。
    • 端到端工作流集成：与其他 MCP 组件（Context Hub、Service Registry、Service MCP、Peer MCP 等）协同工作，形成一套可扩展的 MCP 服务生态。
    • 多种运行模式支持：尽管大多数实现以 STDIO 为传输载体（JSON-RPC over stdin/stdout），设计上可在需要时扩展为 SSE/WebSocket 等传输。

  • 安装与运行步骤（简要）

    • 运行环境：建议 Node.js 版本 18 及以上。
    • 获取代码：克隆仓库后进入 mcp 目录或直接执行仓库中的相应 MCP 服务器脚本，例如 Context Hub MCP、Service Registry MCP 等。
    • 运行服务器：直接执行相应的 MCP 服务器脚本（例如 context-hub-mcp、service-registry-mcp、service-mcp-server 等）。服务器以命令行脚本的形式启动，监听并处理来自 MCP 客户端的 JSON-RPC 请求。
    • 连接客户端：MCP 客户端通过标准输入/输出与 MCP 服务器进行 JSON-RPC 通信；需要确保客户端配置的服务器端启动命令与参数正确指向相应 MCP 服务器。

  • 服务器配置（JSON，供 MCP 客户端使用的配置信息示例） 说明：下列 JSON 用于描述 MCP 客户端如何连接与启动对应 MCP 服务器。配置信息仅用于 MCP 客户端将服务器接入其连接池，实际启动参数需结合具体 MCP 服务器脚本与部署方式来设置。 示例 1（Context Hub MCP 服务器） { "serverName": "jfl-context-hub-mcp", "command": "node", "args": ["./mcp/context-hub-mcp.js"], "description": "Context Hub 的 MCP 服务端，提供统一上下文查询与工具执行入口。" }

    示例 2（Service Registry MCP 服务器） { "serverName": "jfl-service-registry-mcp", "command": "node", "args": ["./mcp/service-registry-mcp.js"], "description": "服务注册与发现的 MCP 服务端，暴露 registry 相关工具。" }

    示例 3（通用 Service MCP 服务器模板） { "serverName": "your-service-mcp", "command": "node", "args": ["./mcp/service-mcp-server.js"], "description": "通用 Service MCP 服务器模板，请将实际服务配置替换并确保 .jfl/config.json 可用。" }

    注释要点

    • serverName：唯一标识符，用于 MCP 客户端在全局范围内引用。
    • command/args：启动 MCP 服务器的命令和参数。确保从仓库根路径或对应部署路径能正确定位脚本。
    • 说明字段为帮助 MCP 客户端理解与选择的文本信息，实际客户端连接不需要解析该字段。
    • MCP 客户端不需要将此份配置直接作为代码运行，而是通过解析该 JSON 来知道如何启动服务器并建立连接。

  • 基本使用方法

    • 启动 MCP 服务器后，MCP 客户端发送初始化请求，服务器返回能力、服务器信息等。
    • 客户端可以调用工具列表、执行工具、查询上下文等，服务器返回结果或错误。
    • 结合 Context Hub 等组件，可以实现跨系统的上下文拼装、工具执行及结果回传。

  • 基本使用示例（操作流程）

    • 启动 Context Hub MCP 服务器
    • 使用 MCP 客户端查询工具列表
    • 使用特定工具执行任务（如 context_get、memory_search 等）
    • 处理返回的结果并渲染到对话或策略推理中

  • 备注

    • 该仓库包含多种 MCP 服务器实现，覆盖不同场景的 MCP 服务端逻辑，具备核心功能实现与运行能力，非单纯示例。
    • MCP 客户端的具体连接方式、认证、传输协议扩展等实现需结合实际部署环境进行适配。

服务器信息

访问项目