使用说明

• 项目简介

  • ekkOS Memory MCP Server 是一个基于 MCP（Model Context Protocol）的后端服务，旨在向大语言模型（如 Claude、GPT-4 等）提供持久化记忆、可执行工具以及可渲染的提示/模板等能力，形成一个可扩展、可安全管理的上下文服务框架。
  • 服务器通过 JSON-RPC 与客户端通信，核心能力包括：管理与提供资源/工具、执行工具、提供并渲染提示模板、以及对话会话与记忆的持续学习与追踪。

• 主要功能点

  • 资源与工具的托管与查询（Resource、Tool 的注册与暴露，及其描述、输入输出定义）
  • 提示模板与对话提示的定义与渲染
  • 记忆系统的多层结构与检索（如模式、会话、语义、代码库等），并支持记忆的 Forge（生成 Pattern）与 Recall 等工作流
  • JSON-RPC 接口实现，支持多种传输（如 Stdio）
  • 会话管理、能力声明与安全访问（通过 API keys、用户 ID 分类访问）
  • 针对 Golden Loop 的记忆应用跟踪、结果上报与模式演化的机制

• 安装步骤

  • 运行前提：Node.js 18+
  • 全局安装（快速体验）
    • npm install -g @ekkos/mcp-server
  • 运行服务器（示例，实际可结合 README 的方式启动）
  • 服务器提供的接口与工具将暴露给 MCP 客户端使用，客户端通过配置连接到该服务器

• 服务器配置（供 MCP 客户端连接使用的配置信息，以下 JSON 为示例，请按实际环境替换 key 与 user id）

  • server_name: "ekkos-memory"
  • command: "npx"
  • args: ["-y", "@ekkos/mcp-server"]
  • env（可选）:
    • EKKOS_API_KEY: "your-api-key"
    • EKKOS_USER_ID: "your-user-id"
  • 说明：
    • 该配置用于 MCP 客户端在启动时自动连接到该 MCP 服务器。MCP 客户端需要至少包含 server name、启动命令和参数来建立连接，服务器端具体实现会根据配置信息建立与客户端的 JSON-RPC 会话。
  • 注：
    • README 中提供了常见的使用路径和示例，实际部署时请参考项目中的配置示例进行调整。

• 基本使用方法

  • 启动服务器后，MCP 客户端（如集成于 Cursor、Windsurf、VS Code、Claude Code 等环境）将通过配置的启动命令启动并连接到该服务器。
  • 客户端可通过 MCP 的工具调用接口、检索记忆、 Forge/recall/directive 等流程，服务器将按定义的工具与数据模型执行，并返回标准化的 JSON-RPC 响应。
  • 开发者可通过工具和方法（如 search_memory、forge_pattern、track_application、record_outcome 等）实现记忆的检索、扩展与评估，以提升对话上下文的丰富性和一致性。