使用说明（Markdown 格式）

• 项目简介

  • aimem 提供一个本地化的 MCP 服务器，能够通过标准化的 JSON-RPC 接口向大语言模型客户端提供上下文数据、工具执行能力以及可渲染的 Prompt 模板等核心能力，帮助 LLM 在本地环境中获得更安全、可控的上下文服务。

• 主要功能点

  • MCP 服务核心：实现 ListTools 与 CallTool 形式的 MCP 请求与响应，支持工具注册、执行与返回结果。
  • 工具集成：对外暴露核心工具，例如 aimem_query、aimem_verify、aimem_conversations 等，支持结构、对话、决策与提交的查询与验证。
  • 资源与结构管理：提供对代码结构、文件、对话、提取物等资源的读取和查询能力，并维持内存/上下文的引用关系。
  • 安全与扩展：通过 DIK（数字接口知识） guards 规则与推断能力，提供对触发的行动的推断与回退机制，便于对外部工具的安全调用与审计。
  • 多传输支持：在 MCP 服务器实现中采用标准的 MCP 服务端结构，理论上可扩展为 StdIO、SSE、WebSocket 等传输方式，以支持多场景客户端。

• 安装步骤

  • 获取代码：将仓库克隆到本地或直接使用已发布版本。
  • 安装依赖：在项目根目录执行安装命令（如 npm install）以获取运行所需依赖。
  • 构建/安装：如需要本地开发，请按项目说明进行构建并在全局环境中链接可执行文件。
  • 启动 MCP 服务器：通过命令启动 MCP 服务器，例如在项目提供的 CLI 中执行 “aimem mcp-serve” 用以启动 MCP 服务器。

• 服务器配置（MCP 客户端使用的不需要，以下为配置信息示例，客户端请使用该配置连接服务器） { "name": "aimem", "version": "0.1.0", "server": { "command": "aimem", "args": ["mcp-serve"] } } 注释说明：

• name: MCP 服务器名称，保持与服务端实现一致

• version: MCP 服务器实现版本

• server.command: 启动服务器的可执行命令

• server.args: 启动服务器所需参数（此处为启动 MCP 服务的子命令）

• 基本使用方法

  • 启动：执行启动命令开启 MCP 服务器。
  • 调用格式：客户端通过 JSON-RPC 请求向服务器发送 ListTools 和 CallTool 请求，以获取可用工具、执行工具并返回结果。
  • 监控与诊断：通过服务状态、日志等方式监测服务器运行情况，确保工具可用与数据正确。
  • 扩展与自定义：如需增加新的工具或能力，可扩展 MCP Server 的工具集合及相关处理逻辑，确保返回符合 MCP 规范的响应。