Claude Context Optimization MCP Server

使用说明(Markdown)

  • 项目简介

    • 该仓库实现了一个以 MCP(Model Context Protocol)为基础的后端服务器组件,专注于对大语言模型输入上下文的优化与管理,帮助 LLM 客户端在对话过程中获得更高质量、可控的上下文信息和功能扩展。
  • 主要功能点

    • MCP 服务器核心接口:
      • 读取资源(Resources)与数据管理
      • 注册和执行 Tools(工具调用,如 compress_context、extract_heavy_hitters、build_optimized_prompt)
      • 定义和渲染 Prompt 模板(Prompts),支持可定制的 LLM 交互
    • 通信机制:通过 JSON-RPC,使用标准的初始化与工具调用流程
    • 实现方式:
      • 提供一个名为 mcp-context-server.js 的服务器实现,采用 stdio 传输模式,支持如下方法:
        • initialize:服务器初始化能力声明
        • tools/list:列出可用工具及其输入结构
        • tools/call:调用具体工具,并返回结果
    • 依赖实现:
      • contextOptimizer.js 提供上下文优化的核心逻辑,包括 Heavy-Hitter 提取、 compressive Context、RAG(检索/排序/压缩/综合)等阶段
      • mcp-context-server.js 将 contextOptimizer 的能力暴露为 MCP 工具入口,支持对接方通过 MCP 客户端进行调用
  • 安装步骤(快速入门)

    • 确保本地已安装 Node.js 环境
    • 直接运行服务(示例路径为仓库根目录):
      • node project-team/hooks/mcp-context-server.js serve
    • 说明:该服务器采用 stdio 传输,适合嵌入式或管道式集成场景,MCP 客户端需要提供启动命令以与该服务器建立连接。
  • 服务器配置(MCP 客户端需提供的配置示例,JSON 格式)

    • 配置名称:context-optimizer
    • 启动命令与参数(示例)
    • 注释说明:该配置用于 MCP 客户端在初始化阶段知道如何启动服务器,以及如何与之通信 配置示例(JSON): { "serverName": "context-optimizer", "command": "node", "args": ["project-team/hooks/mcp-context-server.js", "serve"], "description": "MCP Context Optimizer Server:提供 compress_context、extract_heavy_hitters、build_optimized_prompt 等工具的上下文优化能力,通信通过 STDIO 的 JSON-RPC 实现。" }
  • 基本使用方法(简易流程)

    • MCP 客户端启动后,通过下面的流程调用工具:
      • 发送 initialize 请求,获取服务器能力信息
      • using tools/list,获取可用工具及输入结构
      • 调用 tools/call,指定要执行的工具及参数
      • 服务器返回执行结果及必要的上下文信息
    • 典型用例包括对大文本的上下文提取、摘要、重组并将结果作为后续 Prompt 的输入渲染返回
  • 其他要点

    • 该实现聚焦于对上下文进行高效管理,结合 Heavy-Hitter 提取、Compress 模式、以及 H2O/LLM 边缘处理的混合策略,帮助 LLM 客户端在大上下文场景下保持信息的关键性与可用性
    • 服务器端暴露的工具和接口可扩展,便于嵌入其他 MCP 客户端场景

服务器信息