MemoryLane MCP 服务器

使用说明内容（Markdown格式）

• 项目简介

  • MemoryLane MCP 服务器是一个后端服务，基于 MCP（Model Context Protocol）向 AI 客户端提供可查询的资源、可调用的工具，以及可渲染的 Prompt 模板。服务器通过 JSON-RPC-like 请求/响应与客户端通信，并可通过多种传输方式（如 STDIO、SSE、WebSocket 等）进行扩展。

• 主要功能点

  • 资源与数据访问：提供对本地资源、历史活动等数据的访问能力，供 LLM 客户端查询与检索。
  • 工具注册与执行：定义并注册可执行的工具（Tools），使 LLM 客户端能够请求执行外部功能。
  • Prompts 定义与渲染：提供可定制的 Prompt 模板，用于与 LLM 的交互模式和上下文渲染。
  • JSON-RPC 通信：通过标准化的 JSON-RPC 结构处理请求与响应。
  • 会话与能力声明：服务端实现会话和能力声明，支持多种传输协议（包括 STDIO）。
  • 延迟加载服务：服务端在需要时初始化存储与嵌入服务，保持启动轻量化。

• 安装与运行

  • 该仓库包含完整的 MCP 服务器实现及其启动入口。运行时会使用 Electron 的可执行文件配合 mcp-entry.js 作为入口，通过内建的 START 过程初始化数据库与嵌入服务，并启动 MCP 服务器。
  • 运行时依赖外部 MCP 客户端与服务器实现的组件（如 数据库、向量嵌入服务、OpenRouter/嵌入等模型服务）。

• 服务器配置（给 MCP 客户端的配置信息说明）

  • 说明：MCP 客户端需要知道用于连接 MCP 服务器的启动命令以及参数。以下信息基于仓库实现的服务器启动方式提供，便于客户端以同样的方式启动与连接。
  • 服务器名称（server name）：memorylane
  • 启动命令（command）：MemoryLane 的 Electron 可执行文件路径
  • 参数（args）：包含 mcp-entry.js 的入口路径，例如应用包内的 out/main/mcp-entry.js
  • 环境变量（env）：{ "ELECTRON_RUN_AS_NODE": "1" }，用于在 Node 运行时执行 MCP 服务器入口
  • 备注：MCP 客户端通过 STDIO 与服务器通信。服务器会在首次启动时初始化数据库与嵌入服务，并暴露工具与 prompts。实际部署中，请将 command 替换为具体的可执行文件路径，args 指向应用包内的 mcp 入口脚本。

• 基本使用方法

  • 将 MemoryLane MCP 服务器与客户端对接：客户端按 MCP 标准配置读取上述 server 信息，启动后通过 STDIO 进行请求响应交互。
  • 使用工具与 Prompts：客户端可以调用注册好的工具（如 search_context、browse_timeline、get_activity_details 等）并获取返回的结构化结果，用于在 LLM 会话中建立上下文。
  • 服务初始化：服务器启动时会自动加载存储与嵌入服务，如有需要可注入自定义服务以覆盖默认实现。
  • 部署与运维：在生产环境中，请确保服务器的数据库路径可写、嵌入服务可访问，并监控日志输出以确保工具与提示模板的正常工作。

• 额外信息

  • 服务器逻辑中包含工具、Prompts 的注册与初始化逻辑，便于扩展和自定义。
  • 服务器端实现了对多种传输协议的潜在支持能力，提升与不同 LLM 客户端的兼容性与灵活性。