AI导哈

会话摘要管理服务器

一个轻量级的MCP服务器，用于管理LLM（如Claude）的丰富会话摘要和备忘录，提供本地文件系统的持久化存储，支持会话历史版本跟踪，并提供存储、检索和列出摘要的工具。

  • by doggybee
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 doggybee/mcp-server-memo

使用说明

MCP服务器备忘录

一个轻量级的MCP（模型上下文协议）服务器，用于管理Claude等LLM的丰富会话摘要和备忘录。此服务器使用本地文件系统提供持久存储，支持会话历史版本跟踪，并提供用于存储、检索和列出摘要的工具。

概述

MCP服务器备忘录被设计为LLM的内存助手，允许它们通过MCP工具界面存储和检索详细的会话记录。服务器：

  • 保存历史 -会话的所有历史版本（相同的sessionId）都会被保留，而不仅仅是最新版本
  • 订购时间 -会话的多个版本按时间顺序组织，便于跟踪会话的发展
  • 本地存储 -使用本地文件系统，不需要外部数据库
  • 符合MCP标准 -遵循模型上下文协议规范提供工具接口
  • 性能优化 -针对文件I/O和并发操作进行了优化
  • 最小依赖性 -简洁的设计，易于维护和扩展

安装

# Clone the repository
git clone https://github.com/doggybee/mcp-server-memo.git
cd mcp-server-memo

# Install dependencies
npm install

# Build the project
npm run build

配置

服务器使用以下配置选项：

  • MCP_SUMMARY_DIR：用于存储摘要的目录（默认： ./summaries/)

您可以通过环境变量设置这些选项：

export MCP_SUMMARY_DIR="/path/to/summaries"

运行服务器

# Standard startup
npm start

# Development mode (with auto-reload)
npm run dev

# Start with logging to file
npm run start:log

MCP工具

服务器提供以下MCP工具：

1.意外摘要

创建会话摘要的新版本，而不删除以前的版本。

参数：

  • sessionId （字符串，必填）：对话会话的唯一标识符。 生成此ID是客户端应用程序的责任。 它应该在新的逻辑对话会话开始时生成一次。 建议： 使用标准 UUID（版本4） 库以您的编程语言提供，以确保唯一性。然后，客户端必须重用 相同 为所有后续生成的ID upsertSummary 与该特定会议有关的电话。
  • summary （string，必填）：会话历史记录/日志的详细内容。每次调用都会在会话历史记录中创建一个新版本，而不是覆盖以前的版本。
  • title （字符串，可选）：会话的简短描述性标题。
  • tags （string[]，可选）：用于对会话进行分类的关键字或标签。

行为：

  • 使用新的时间戳创建新文件
  • 保留所有以前的版本
  • 返回新版本的时间戳

2.获取摘要工具

检索特定会话摘要的最新版本。

参数：

  • sessionId （string，必填）：要检索的会话摘要的唯一ID。
  • maxLength （number，可选）：如果提供，请将检索到的摘要文本截断到此最大长度。

退货：

  • 最新的会话摘要对象（JSON格式）

3.列表摘要工具

列出可用摘要（仅显示每个会话的最新版本），并支持过滤、排序和分页。

参数：

  • tag （字符串，可选）：按特定标记筛选会话。
  • limit （数字，可选）：限制结果。
  • offset （数字，可选）：分页偏移量。
  • sortBy （字符串，可选）：排序字段（“上次更新”或“标题”）。默认值：“lastUpdated”。
  • order （string，可选）：排序顺序（'sc'或'sec'）。默认值：“desc”。

退货：

  • 摘要元数据对象列表（JSON格式），每个会话仅包含最新版本

4.更新元数据

仅更新会话最新版本的元数据（标题和/或标签），而不更改摘要内容或时间戳。

参数：

  • sessionId （string，必填）：要更新其元数据的会话的唯一ID。
  • title （字符串，可选）：新标题。如果省略，标题保持不变。
  • tags （string[]，可选）：新标签数组。如果省略，标签将保持不变。

注： 至少一个 title 或 tags 必须提供。

行为：

  • 不更新文件名或 lastUpdated 领域
  • 仅修改指定的元数据字段
  • 不影响摘要内容

5.附录摘要

将内容附加到会话摘要中，创建一个包含以前内容和新内容的新版本。

参数：

  • sessionId （字符串，必填）：对话会话的唯一标识符。
  • content （string，必填）：要附加到会话的内容。这将添加到现有内容中并另存为新版本。
  • title （string，可选）：会话的可选标题。
  • tags （string[]，可选）：用于对会话进行分类的可选标记。

行为：

  • 读取现有的最新摘要（如果有的话）
  • 在内容之间添加两行新行并附加新内容
  • 使用新的时间戳创建新文件
  • 保留所有以前的版本

6.列出所有摘要工具

列出所有可用的摘要和基本信息（仅每个会话的最新版本）。

参数：

  • 无

退货：

  • 包含基本信息的所有可用摘要列表（JSON格式）

7.获取会话历史记录

按从最新到最旧的顺序检索特定会话的所有历史版本。

参数：

  • sessionId （string，必填）：要检索历史记录的会话的唯一ID。

退货：

  • 所有版本及其完整内容的列表（JSON格式）

客户端工作流示例

下面是一个客户端应用程序如何与此服务器交互的示例：

import { v4 as uuidv4 } from 'uuid';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

// Initialize client
const transport = new StdioClientTransport({
  command: 'node',
  args: ['dist/index.js'],
  cwd: process.cwd()
});

const client = new Client({
  name: 'example-client',
  version: '1.0.0'
});

await client.connect(transport);

// Function to generate new session ID (done once per logical session)
function createNewSession() {
  return uuidv4();
}

// Function to append to an existing session
async function appendToSession(sessionId, newContent) {
  return client.callTool({
    name: "appendSummary",
    arguments: {
      sessionId,
      content: newContent,
      title: "Example Session",
      tags: ["example", "demo"]
    }
  });
}

// Function to get session history
async function getSessionHistory(sessionId) {
  const response = await client.callTool({
    name: "getSessionHistory",
    arguments: { sessionId }
  });
  
  const result = JSON.parse(response.content[0].text);
  if (result.success) {
    return result.history;
  }
  
  throw new Error(result.error || "Failed to get session history");
}

// Usage example
const sessionId = createNewSession();

// Add initial content
await appendToSession(sessionId, "Initial conversation data");

// Add more content later in the conversation
await appendToSession(sessionId, "Second part of the conversation");
await appendToSession(sessionId, "Final part of the conversation");

// Get the full history
const history = await getSessionHistory(sessionId);
console.log(`Session ${sessionId} has ${history.length} versions`);

项目结构

mcp-server-memo/
├── dist/                 # Compiled JavaScript output
├── src/                  # TypeScript source code
│   ├── config.ts         # Server configuration
│   ├── index.ts          # Main entry point
│   ├── storage.ts        # File storage utilities
│   ├── tools.ts          # MCP tool implementations
│   └── types.ts          # TypeScript type definitions
├── summaries/            # Directory for storing session data
│   └── .gitkeep          # Ensures directory is included in git
├── package.json          # Project metadata and dependencies
├── tsconfig.json         # TypeScript configuration
└── LICENSE               # MIT License file

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP