MCP 服务器

项目简介

MCP 服务器是一个基于模型上下文协议（Model Context Protocol, MCP）的工具，用于管理会话数据。它提供了多种功能，包括会话历史记录、内容追加、元数据修改等。

安装指南

安装依赖

npm install @modelcontextprotocol/sdk client dist/index.js

配置选项

• SUMMARIES_DIR: 用于存储会话文件的目录，默认为 "summaries"。
• 其他配置项请参考 src/config.ts。

运行命令

npm start

MCP 工具说明

工具列表

1. appendSummary

   • 描述：向现有会话追加内容，生成新版本。
   • 参数：
     • sessionId: 会话 ID。
     • content: 待追加的内容。
     • 可选参数：title, tags。

2. getSessionHistory

   • 描述：获取指定会话的所有历史记录。
   • 参数：
     • sessionId: 会话 ID。

3. 其他工具请参考 src/tools.ts。

客户端使用示例

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

// 初始化客户端
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);

// 创建新会话 ID
function createNewSession() {
  return uuidv4();
}

// 追加内容到现有会话
async function appendToSession(sessionId, newContent) {
  return client.callTool({
    name: "appendSummary",
    arguments: {
      sessionId,
      content: newContent,
      title: "Example Session",
      tags: ["example", "demo"]
    }
  });
}

// 获取会话历史记录
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");
}

// 示例用法
const sessionId = createNewSession();

// 添加初始内容
await appendToSession(sessionId, "Initial conversation data");

// 后续追加内容
await appendToSession(sessionId, "Second part of the conversation");
await appendToSession(sessionId, "Final part of the conversation");

// 获取历史记录
const history = await getSessionHistory(sessionId);
console.log(`Session ${sessionId} has ${history.length} versions`);

项目结构

mcp-server-memo/
├── dist/                 # 编译后的 JavaScript 输出
├── src/                  # TypeScript 源代码
│   ├── config.ts         # 服务器配置
│   ├── index.ts          # 入口文件
│   ├── storage.ts        # 文件存储工具
│   ├── tools.ts          # MCP 工具实现
│   └── types.ts          # TypeScript 类型定义
├── summaries/            # 存储会话数据的目录
│   └── .gitkeep          # 确保目录被 Git 包括
├── package.json          # 项目元数据和依赖项
├── tsconfig.json         # TypeScript 配置文件
└── README.md             # 项目说明文档

许可证

本项目采用 麻省理工学院许可协议。

如需更多信息，请参考 MCP 协议文档。