MCP Server Memo

🚀 MCP サーバー

MCP サーバーは、モデルコンテキストプロトコル（Model Context Protocol, MCP）に基づくツールで、セッションデータの管理を行います。セッション履歴、内容の追加、メタデータの変更など、様々な機能を提供します。

🚀 クイックスタート

MCP サーバーを使ってセッションデータを管理することができます。以下のセクションでは、インストール方法、設定オプション、実行コマンド、ツールの説明、クライアントの使用例、プロジェクト構造、ライセンス情報について説明します。

✨ 主な機能

• セッション履歴の管理
• セッションへの内容追加
• メタデータの変更

📦 インストール

依存関係のインストール

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

🔧 設定オプション

• SUMMARIES_DIR：セッションファイルを保存するディレクトリで、デフォルトは "summaries" です。
• その他の設定項目については、src/config.ts を参照してください。

実行コマンド

npm start

📚 ドキュメント

ツールリスト

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             # プロジェクト説明ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンス の下で提供されています。

詳細情報については、MCP プロトコルドキュメント を参照してください。