Temp Notes MCP Server

Temp Notes MCP サーバー

AI エージェントが会話やコンテキストをまたいで一時的な情報を保存・取得できるようにする、Model Context Protocol（MCP）サーバーです。

目次

• 目的
• 主な機能
• クイックスタート
• インストール
• ツール
• 使用例
• ユースケース
• ノートの保存
• コントリビューション
• ライセンス

目的

Temp Notes MCP サーバーは、複数の会話を通じて、またはコンテキストウィンドウの制限を超える複雑なタスクに取り組む際に、AI エージェントが状態とコンテキストを維持するための、シンプルでありながら強力な方法を提供します。エージェントがノート、チェックリスト、コードスニペットなどの情報を保存し、後で取得できる一時的なメモリシステムとして機能します。

主な機能

• 会話をまたいで一時的な情報を永続的に保存
• ノートの読み取り、書き込み、追記を行うシンプルな API
• 軽量で、既存のワークフローに簡単に統合可能
• 複雑な複数ステップのタスクを、管理しやすい単位に分割可能

クイックスタート

1. npx を使って MCP の設定にサーバーを追加します（インストール不要）：

   {
     "mcpServers": {
       "temp-notes": {
         "command": "npx",
         "args": ["-y", "@landicefu/temp-notes-mcp-server"],
         "disabled": false
       }
     }
   }
   

2. 会話で使用を開始します：

   // Store information
   await use_mcp_tool({
     server_name: "temp-notes",
     tool_name: "write_note",
     arguments: { content: "Important information to remember" }
   });
   
   // Retrieve information later
   const result = await use_mcp_tool({
     server_name: "temp-notes",
     tool_name: "read_note",
     arguments: {}
   });
   

インストール

オプション 1：npx を使う（インストール不要）

1. MCP の設定にサーバーを追加します：

   {
     "mcpServers": {
       "temp-notes": {
         "command": "npx",
         "args": ["-y", "@landicefu/temp-notes-mcp-server"],
         "disabled": false
       }
     }
   }
   

このオプションでは、グローバルインストールをせずに npx でサーバーを直接実行します。

オプション 2：npm からインストールする

1. パッケージをグローバルにインストールします：

   npm install -g @landicefu/temp-notes-mcp-server
   

2. MCP の設定にサーバーを追加します：

   {
     "mcpServers": {
       "temp-notes": {
         "command": "temp-notes-mcp-server",
         "disabled": false
       }
     }
   }
   

オプション 3：ソースからインストールする

1. リポジトリをクローンします：

   git clone https://github.com/landicefu/temp-notes-mcp-server.git
   cd temp-notes-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

4. MCP の設定にサーバーを追加します：

   {
     "mcpServers": {
       "temp-notes": {
         "command": "node",
         "args": ["/path/to/temp-notes-mcp-server/build/index.js"],
         "disabled": false
       }
     }
   }
   

ツール

Temp Notes MCP サーバーでは、以下のツールを利用できます。

clear_note

現在のノートを消去し、空にします。

{
  "type": "object",
  "properties": {},
  "required": []
}

write_note

現在のノートを新しい文字列で置き換えます。

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The content to write to the note"
    }
  },
  "required": ["content"]
}

read_note

ノートの現在の内容を返します。

{
  "type": "object",
  "properties": {},
  "required": []
}

append_note

現在のノートに新しいテキストを改行して追記します。オプションで区切り線を追加できます。

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The content to append to the note"
    },
    "include_separator": {
      "type": "boolean",
      "description": "Whether to include a separator line (---) before the new content",
      "default": true
    }
  },
  "required": ["content"]
}

使用例

タスクのチェックリストを保存する

// Store a checklist for a complex task
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: {
    content: "# Project Refactoring Checklist\n\n- [ ] Analyze current architecture\n- [ ] Identify performance bottlenecks\n- [ ] Create new component structure\n- [ ] Implement data layer changes\n- [ ] Update UI components\n- [ ] Write tests\n- [ ] Document changes"
  }
});

保存した情報を取得する

// In a new conversation, retrieve the checklist
const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});

// Result contains the previously stored checklist

進捗を更新する

// Update the note with progress
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: {
    content: "## Architecture Analysis Complete\n\nKey findings:\n- Current structure has circular dependencies\n- Data fetching is inefficient\n- Component reuse is minimal\n\nRecommendation: Implement repository pattern and component composition",
    include_separator: true
  }
});

完了時にノートを消去する

// Clear the note when the task is complete
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

ユースケース

1. 複雑なコーディングタスク

複雑なコーディングタスクに取り組む際、AI エージェントはコンテキストウィンドウの制限に直面することが多く、1 回の会話ですべての手順を完了するのが難しくなります。Temp Notes MCP サーバーを使うと、エージェントは次のことができます。

• 完了すべきタスクのチェックリストを保存する
• 各サブタスクの詳細な説明を記載する
• 特定のサブタスクで確認が必要なファイルを記録する
• 複数の会話をまたいで進捗を追跡する
• そうでなければ失われてしまう重要なコンテキストを維持する

これにより、全体のコンテキストと目標を保ちながら、複雑なタスクを小さく管理しやすい単位に分割できます。

2. 会話をまたいだコンテキストの保持

会話が長くなるにつれてコンテキストウィンドウがいっぱいになり、エージェントが関連情報をすべて維持するのが難しくなることがあります。Temp Notes MCP サーバーを使うと、エージェントは次のことができます。

• 現在のタスクの状況を要約する
• 完了した手順と残っている作業を記録する
• 重要な知見や決定事項を保存する
• 新しい会話で続きを行うための次の手順をまとめる

これにより、ユーザーは進捗を失ったり、情報を繰り返し伝えたりすることなく、新しい会話を始められます。

3. リポジトリ間の情報共有

複数のリポジトリやプロジェクトにまたがって作業する場合、関連する情報を共有するのは難しいことがあります。Temp Notes MCP Server を使用すると、エージェントは次のことができます。

• あるリポジトリのコードスニペットを保存する
• 参照用にファイルの内容を保存する
• 別のプロジェクトで応用するパターンやアプローチを文書化する
• 複数のプロジェクトをつなぐ一時的なドキュメントを作成する

これにより、複雑なセットアップを必要とせず、異なるコンテキスト間でナレッジを共有できます。

4. コラボレーションワークフロー

複数のエージェントやユーザーは、次の方法で互いの作業を引き継いで進めることができます。

• 他のエージェントが利用できる中間結果を保存する
• 異なるエージェントが更新できる共有タスクリストを作成する
• 他の人が参照できるよう、アプローチや手法を文書化する
• 複雑な問題について共通認識を維持する

5. 学習と実験

新しいテクノロジーやアプローチを探る際、エージェントは次のことができます。

• 学習リソースや参考資料を文書化する
• サンプルコードや使用パターンを保存する
• 実験とその結果を記録する
• テクニックやソリューションのナレッジベースを構築する

6. 段階的なドキュメント作成

ドキュメントが必要なプロジェクトでは、エージェントは次のことができます。

• 複数のセッションにわたって段階的に情報を収集する
• ドキュメントを完成させる前に内容を整理する
• 時間をかけて洗練できるドラフトのセクションを保存する
• さまざまなやり取りから例やユースケースを集める

ノートの保存場所

デフォルトでは、Temp Notes MCP Server は次の場所にノートを保存します。

• macOS/Linux の場合：~/.mcp_config/temp_notes.txt（/Users/username/.mcp_config/temp_notes.txt に展開されます）
• Windows の場合：C:\Users\username\.mcp_config\temp_notes.txt

このファイルは、最初にノートを書き込むと自動的に作成されます。ノートを読み込もうとしたときにファイルが存在しない場合、サーバーは空の文字列を返し、次回の書き込み時にファイルを作成します。

サーバーは次の状況に対応します。

• 読み込み時にファイルが存在しない場合：空の文字列を返します
• ディレクトリが存在しない場合：書き込み時にディレクトリ構造を自動的に作成します
• ファイルが破損している、またはアクセスできない場合：適切なエラーメッセージを返します

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。