MCP Server Memo

🚀 MCP 服務器

MCP 服務器是一款基於模型上下文協議（Model Context Protocol, MCP）的實用工具，主要用於管理會話數據。它具備豐富的功能，如會話歷史記錄管理、內容追加以及元數據修改等，能有效提升會話數據管理的效率和便捷性。

🚀 快速開始

MCP 服務器基於模型上下文協議（MCP），可高效管理會話數據。下面為你介紹如何快速開啟使用。

✨ 主要特性

• 提供會話歷史記錄管理功能，方便用戶隨時查看會話的過往信息。
• 支持向現有會話追加內容，並生成新版本，滿足數據更新需求。
• 允許對會話的元數據進行修改，增強數據管理的靈活性。

📦 安裝指南

安裝依賴

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

配置選項

• SUMMARIES_DIR：用於存儲會話文件的目錄，默認為 "summaries"。
• 其他配置項請參考 src/config.ts。

運行命令

npm start

💻 使用示例

基礎用法

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 工具說明

工具列表

1. appendSummary
   • 描述：向現有會話追加內容，生成新版本。
   • 參數：
     • sessionId：會話 ID。
     • content：待追加的內容。
     • 可選參數：title, tags。
2. getSessionHistory
   • 描述：獲取指定會話的所有歷史記錄。
   • 參數：
     • sessionId：會話 ID。
3. 其他工具請參考 src/tools.ts。

項目結構

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 協議文檔。