MCP Server Memo

🚀 MCP Server

The MCP Server is a tool based on the Model Context Protocol (MCP) for managing session data. It offers various functions, including session history, content appending, and metadata modification.

🚀 Quick Start

📦 Installation

Install Dependencies

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

Configuration Options

• SUMMARIES_DIR: The directory for storing session files, with a default value of "summaries".
• For other configuration items, please refer to src/config.ts.

Run Command

npm start

✨ Features

MCP Tools

Tool List

1. appendSummary
   • Description: Append content to an existing session to generate a new version.
   • Parameters:
     • sessionId: The session ID.
     • content: The content to be appended.
     • Optional parameters: title, tags.
2. getSessionHistory
   • Description: Retrieve all historical records of a specified session.
   • Parameters:
     • sessionId: The session ID.
3. For other tools, please refer to src/tools.ts.

💻 Usage Examples

Basic Usage

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

// Initialize the 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);

// Create a new session ID
function createNewSession() {
  return uuidv4();
}

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

// 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");
}

// Example usage
const sessionId = createNewSession();

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

// Append subsequent content
await appendToSession(sessionId, "Second part of the conversation");
await appendToSession(sessionId, "Final part of the conversation");

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

📚 Documentation

Project Structure

mcp-server-memo/
├── dist/                 # Compiled JavaScript output
├── src/                  # TypeScript source code
│   ├── config.ts         # Server configuration
│   ├── index.ts          # Entry file
│   ├── storage.ts        # File storage tool
│   ├── tools.ts          # MCP tool implementation
│   └── types.ts          # TypeScript type definitions
├── summaries/            # Directory for storing session data
│   └── .gitkeep          # Ensure the directory is included in Git
├── package.json          # Project metadata and dependencies
├── tsconfig.json         # TypeScript configuration file
└── README.md             # Project documentation

📄 License

This project is licensed under the MIT License.

For more information, please refer to the MCP Protocol Documentation.