Ember MCP 服务器

关键词

模型上下文本地记忆语义检索提示模板JSON-RPC

使用说明（Markdown 格式）

  • 项目简介

    • Ember MCP 服务器是一个面向模型上下文方案的后端服务，结合 Ember 的记忆、知识、图谱等能力，为大语言模型客户端提供以资源、工具、提示模板为核心的上下文服务。

  • 主要功能点

    • MCP 服务器核心能力
      • 注册并暴露大量工具（Tools），使 LLM 客户端可以通过 MCP 请求调用 Ember 的后端能力（如创建任务、创建问题、检索记忆等）。
      • 注册并暴露提示模板（Prompts），方便 MCP 客户端在对话中调度固定格式的指令和工作流。
      • 提供资源/记忆的读写能力（通过 Ember 内部的存储与查询实现），实现资源管理和数据访问。
      • 会话管理与能力声明（PROMPTS 注册、工具注册、会话上下文、状态追踪等）。
    • 服务器实现要点
      • 通过 Ember V3 的工具层（MCP Tools）实现对 Ember 记忆、边、基线、提案等的操作。
      • 使用 FastMCP 等 MCP 服务框架实现 JSON-RPC 调用的处理与响应。
      • 支持向客户端提供多种传输方式（如 stdio）以及可扩展的工具集和提示集。
    • 运行与集成
      • 作为 Ember V3 的 MCP 服务器启动，通过 ember_server.py（或等价入口）启动并注册所有工具与提示。
      • 客户端通过 MCP 配置连接，发送 JSON-RPC 请求并接收响应。

  • 安装步骤

    • 基本依赖
      • Python 3.11+
      • 依赖项在 setup.py 的 install_requires 中指定，例如 mcp>=1.0.0、numpy>=1.24.0，以及 semantic 支持（sentence-transformers）等。
    • 安装与部署
      • 将代码拷贝到本地目录，执行安装以获取依赖：
        • 运行环境中执行 Python 打包安装（例如 python -m pip install -e .），确保依赖安装完成。
      • 启动 MCP 服务器：
        • 直接运行 Ember MCP 服务器入口脚本，例如 python ember/ember_server.py（具体路径以实际部署为准）。
    • 验证
      • 启动后，服务器应输出注册的工具与提示信息，并对 MCP 客户端的 JSON-RPC 请求做出响应。

  • 服务器配置（MCP 客户端配置示例，JSON 格式，字段含义仅供参考，实际客户端可按需要调整） { "serverName": "ember-v3", "command": "python", "args": ["/path/to/ember-mcp/ember/ember_server.py"], "description": "Ember MCP 服务器（V3）启动入口，用于向客户端暴露 Ember 的资源、工具和提示模板等能力" }

    说明

    • serverName：MCP 服务器的名称，客户端通过该名称识别要连接的服务。
    • command/args：启动服务器所需的命令及参数，客户端无需关心具体实现细节，只需在连接时知道服务器入口即可。
    • 注：MCP 客户端通常仅需知道服务器的启动命令与参数即可建立连接；具体交互通过 JSON-RPC 进行。

  • 基本使用方法

    • 启动服务器后，确保 MCP 客户端配置正确，客户端可通过 JSON-RPC 调用 Ember 的资源、工具、Prompts 等能力。
    • 常见工作流示例
      • 调用 ember_store 保存一个记忆
      • 调用 ember_recall 检索相关记忆
      • 调用 create_proposal 提交修复建议（GATE 流程）
      • 调用 store_daily_summary/store_orchestrator_summary 保存工作流产出
    • 服务器端点职责包含会话管理、能力声明，以及对多种传输协议的支持，以满足 LLM 客户端的上下文服务需求。

  • 关键词 模型上下文, 本地记忆, 语义检索, 知识图谱, 提示模板

  • 分类ID 6

服务器信息

访问项目