MemoryOS MCP 服务端

关键词

健康检查仪表板上下文管理工具执行本地分析

项目简介

MemoryOS 是一个基于 MCP 的后端服务器，旨在向大型语言模型客户端提供结构化的上下文资源、可调用的外部工具以及可渲染的提示模板。它通过 JSON-RPC 与客户端通信，提供健康检查、仪表板、PDF 报告等实用工具，帮助本地化管理和分析软件项目的上下文信息。

主要功能点

  • MCP 服务端实现：实现 MCP 服务器，注册多个工具（如健康检查、修复建议、仪表板生成、PDF 报告、 weekly_pulse 等）并对外提供 JSON-RPC 接口。
  • 健康检查与 CE 模式映射：对本地工程的 CLAUDE.md、技能、内存等进行 45+ 条检查，并输出 Context Engineering 模式（CE Patterns）映射。
  • 工具集成与渲染：提供健康检查报告格式化、仪表板生成功能、PDF 报告生成等工具。
  • 本地化运行：所有分析和渲染都在本地完成，无需外部网络依赖。
  • 兼容性与扩展：代码结构设计为 MCP 服务器的典型实现，便于扩展新工具和新的呈现模板。

安装与运行步骤

  • 快速安装与启动

    • 使用 npx 直接部署并启动 MemoryOS 的 MCP 服务器（本地执行，依赖 Node.js 环境）。
    • 也可通过 Claude Code 的 MCP 设置将 MemoryOS 作为本地服务器接入 Claude Code 的工作流。

  • 运行方式要点

    • 服务器会以 MCP 的标准形态接收并处理请求，提供如下工具接口：check_health、get_fix_suggestions、generate_dashboard、generate_pdf、weekly_pulse、context_pressure、audit_config、import_context、upgrade_brain 等。
    • 服务器默认通过标准输入输出（stdio）作为传输通道，与 MCP 客户端约定的传输方式保持一致。

服务器配置（MCP 客户端使用，不需要向用户展示内部实现）

请以 JSON 形式填写 MCP 服务端的启动信息，示例为可直接使用的配置字段（具体路径根据实际部署调整）： { "name": "memoryos", "command": "node", "args": ["path/to/memory-os/dist/index.js"], "transport": "stdio" } 说明：

  • name: MCP 客户端在 Claude Code 中看到的服务器名称，应与服务器实现中的名称保持一致（memoryos）。
  • command: 启动服务器的可执行命令，这里采用 node。
  • args: 服务器入口文件的路径，指向编译后入口脚本（dist/index.js），确保文件可执行并具备执行权限。
  • transport: MCP 客户端与服务器通信的传输通道，这里使用 stdio（符合 MemoryOS 的实现）。

基本使用方法

  • 运行健康检查
    • 在本地目录执行命令以对当前工程进行健康检查并打开仪表板。
    • 使用 Claude Code 或命令行直接触发 Health Check，MemoryOS 会输出报告文本并生成仪表板（HTML 文件）以及可选的 PDF 报告。
  • 查看与使用仪表板
    • 检查健康检查输出文本中的摘要信息，仪表板文件将暴露在默认输出位置（通常是项目根目录下的 health-check-dashboard.html/health-check-report.html 等）.
  • 与 MCP 客户端对接
    • 使用上述配置文件中的命令与参数启动 MCP 服务器，MCP 客户端（Claude Code 等）通过 JSON-RPC 调用 MemoryOS 提供的工具。

注：上述说明基于仓库内实现的 MCP 服务器与工具集合，目标是在本地提供稳定、可扩展的 MCP 服务端能力，而非简单示例代码。

服务器信息

访问项目