Mind 模型上下文服务端

关键词

上下文服务资源管理工具执行提示模板嵌入检索

使用说明（Markdown 格式）

项目简介

Mind 是一个 Bun + TypeScript 项目，提供命令行工具、一个 MCP 服务器以及可视化的内存管理界面。MCP 服务器作为后端，托管资源 (Resources)、注册并执行工具 (Tools)、定义并渲染 Prompts。通过 JSON-RPC 与 LLM 客户端进行通信，支持多传输协议（STDIO、HTTP、WebSocket 等），为 AI 应用提供安全、可扩展的上下文服务框架。内存数据存储在 SQLite 数据库中，支持分层管理和高效查询。

主要功能点

  • MCP 服务器核心能力
    • 托管与管理资源与数据访问能力，允许客户端读取、查询与操作资源。
    • 注册并执行 Tools，LLM 可以通过工具调用外部功能（如查询内存、管理空间、搜索、链接等）。
    • 定义与渲染 Prompt 模板，便于 LLM 与用户交互时的上下文与指令化输出。
    • 会话管理与能力声明，支持多传输协议，确保与不同客户端的连接与能力协商。
  • 数据模型与存储
    • 使用 SQLite 数据库（mind.db），支持 Full-Text Search、标签、链接、以及 4 级内存层次（T1~T4）。
    • 支持 Embeddings（RAG）与向量检索，提升语义检索能力。
  • MCP 传输模式
    • STDIO 模式（标准输入输出）方便本地集成与测试。
    • HTTP 模式（start --http）提供对外可访问的 MCP 接口，适合云端/跨进程集成。
  • 组件与代码结构
    • Tools（Spaces、Memories、Tiers、Links、Search、Checkpoint、System 等）实现了丰富的 MCP 操作入口。
    • 界面与 API 服务器并非 MCP 的核心，仅作为周边功能，如网页端内存管理和 API 查询。
  • 安全与扩展
    • 提供显式的会话创建与关闭流程，支持多客户端并发，具备扩展性与可观测性。
    • 支持 OpenAI Embeddings 的可选开启（RAG），可在需要时对内存进行语义检索。

安装与运行步骤

  • 准备工作
    • 确保环境中安装了 Bun（用于依赖与打包）以及 Node.js 运行环境。
    • 获取代码并安装依赖（bun install）。
  • 运行 MCP 服务器
    • STDIO 模式（直接在同一进程中通过标准输入输出与客户端通信）：
      • 运行命令 mind mcp
    • HTTP 模式（对外提供 MCP 接口，客户端通过 URL 连接）：
      • 运行命令 mind mcp start --http
      • 默认端口为 7438，可以通过 --port 指定端口
  • 服务器状态与停止
    • 检查服务器状态：根据启动模式，查看控制台输出或进程状态。
    • 停止服务器：发送中止信号或使用 mind mcp stop（若支持）来停止 MCP 服务。

服务器配置（用于 MCP 客户端连接 Mind 的 MCP 服务器）

说明：MCP 客户端需要一个连接目标来建立通信。以下描述给出合理的配置思路，具体请按客户端实现的格式进行配置。

  • 连接模式 A：HTTP 模式
    • 服务器名称（server name）：mind
    • 启动命令与参数（解释性描述，非代码示例）：
      • 启动 Mind 程序的命令为“mind”，子命令为“mcp start --http --port 7438”（若使用其他端口，请替换端口号）。
      • 该模式下 MCP 服务对外提供 HTTP 接口，客户端通过 http://localhost:7438/mcp 进行 JSON-RPC 调用。
    • 客户端需要连接的 MCP URL 为 http://localhost:7438/mcp。
  • 连接模式 B：STDIO 模式
    • 服务器名称（server name）：mind
    • 启动命令与参数（解释性描述，非代码示例）：
      • 启动 Mind 程序的命令为“mind”，子命令为“mcp”。
      • 该模式下 MCP 通过当前进程的标准输入输出与客户端通信，适合嵌入式或同进程的集成场景。
    • 客户端通过与 MCP 的 STDIO 通道进行交互，通常无需额外的网络配置。

注：以上配置仅用于帮助 MCP 客户端了解如何启动并连接到 Mind 的 MCP 服务器。具体 JSON 配置格式依赖于客户端实现，但核心字段应包含：

  • server: mind
  • command: 启动服务的可执行路径
  • args: 启动参数数组
  • 连接方式/URL（若使用 HTTP 模式）

基本使用方法（LLM 与 Mind 的集成示例）

  • 启动后端
    • 以 HTTP 模式启动后端后，确保 MCP 服务在指定端口监听（默认 7438），并可通过 /mcp 路径访问。
  • 与 LLM 集成
    • 使用支持 MCP 的工具链（如 Claude Code、OpenCode 等）在配置中指向 Mind 的 MCP 服务地址（如 http://localhost:7438/mcp）。
    • 通过 MCP 的 Tools 进行内存查询、创建空间、管理内存、执行推理相关任务等。
  • 运行流程简述
    • Mind 通过 MCP 提供的工具接口暴露资源和功能，LLM 发送 JSON-RPC 请求调用工具，Mind 返回结构化的 JSON-RPC 响应或通知。
    • 当使用 Embeddings（RAG）时，可以对内存进行语义检索以提升相关性。

若需要进一步的部署与集成细节，请参考仓库中的 MCP 工具实现和服务器启动脚本，以及 open 文档中的示例用法。

服务器信息

访问项目