使用说明 (Markdown 格式)

• 项目简介

  • Cortex Memory 的 MCP 服务器实现，用于托管资源、注册和执行工具，以及定义和渲染 Prompt 模板，供 LLM 客户端调用并获取上下文服务。

• 主要功能点

  • 提供内存管理相关的工具接口（如存储、查询、列出、获取内存等），可通过 MCP 客户端调用
  • 实现 MCP Server Handler，支持 MCP 的服务器能力声明、工具列表与 Tool Call
  • 使用 stdio 传输的 MCP 服务，便于在本地或容器内进行测试与集成
  • 通过配置文件 config.toml 配置服务器、向量数据库、LLM 服务等参数
  • 与 Cortex Memory 的核心服务集成，提供对外部 LLM 的工具化调用能力

• 安装步骤

  • 需要 Rust 环境（Stable / nightly 均可）
  • 构建并运行 MCP 服务器二进制
  • 常见方式：cargo run --bin cortex-mem-mcp -- --config config.toml
  • 也可通过 cargo install cortex-mem-mcp 安装后运行
  • 提供 agent 标识以绑定特定代理上下文：可通过 --agent <agent-id> 指定

• 服务器配置（供 MCP 客户端参考，实际客户端不需要此 JSON，但用于服务器端初始绑定与文档说明）

  • server_name: Cortex Memory MCP Server
  • command: cortex-mem-mcp
  • args: ["--config", "/path/to/config.toml", "--agent", "<agent-id>"]
  • 说明：config.toml 需包含服务器、LLM、向量数据库、内存参数等配置，agent-id 用于区分不同代理的内存上下文

• 基本使用方法

  • 启动：在包含 config.toml 的目录执行上述 cargo 命令
  • 连接：MCP 客户端通过 JSON-RPC 调用服务器暴露的工具（store_memory、query_memory、list_memories、get_memory 等）
  • 运维：通过日志输出和标准输出了解服务器运行状态；可在 config.toml 调整日志、并发等参数

• 设计与实现要点

  • MCP 服务器端负责管理会话、能力声明、以及向 LLM 客户端暴露的工具
  • 支持通过 JSON-RPC 的调用传输资源、工具和提示模板
  • 集成 Cortex Mem 的核心组件，确保内存存储、查询、优化等操作可作为工具被外部 Agent 调用

• 兼容性与扩展

  • 以后可扩展更多工具和资源类型，增加更多 Prompt 模板以支持不同的对话场景
  • 迭代性地扩展对不同传输协议的支持（如 Stdio、SSE、WebSocket 等）

• 关键词

  • 内存管理, LLM 集成, 工具执行, JSON-RPC, 服务实现

• 分类

  • 分类ID: 6