Temp Notes MCP Server

🚀 温度笔记使用説明

Temp Notes は、多段階または多セッションのタスクにおいてコンテキストを保存および復元するための補助ツールです。特に、複数の会話にまたがって複雑なタスクを完了する必要があるシナリオに適しています。

✨ 主な機能

• 永続的な保存：ノートの内容は、明示的に削除されるまでローカルファイルに長期間保存されます。
• 独立したセッション：各新しい会話では新しい空白のノートが作成され、データの混在を防ぎます。
• ファイルパス：
  • macOS/Linux システム：~/.mcp_config/temp_notes.txt（実際のパスは /Users/username/.mcp_config/temp_notes.txt）
  • Windows システム：C:\Users\username\.mcp_config\temp_notes.txt

📦 インストール

コマンドラインツールのインストール

// CLIツールをインストールする
npm install -g mcp-temp-note-cli

💻 使用例

基本的な使用法

初期化

// 新しいノートを初期化する
mcp_temp_note init

内容の書き込み

// 新しいテキスト内容を書き込む
mcp_temp_note write "あなたのノート内容"

内容の読み取り

// 現在のノート内容を読み取る
mcp_temp_note read

内容のクリア

// 現在のノート内容をクリアする
mcp_temp_note clear

高度な使用法

タスクチェックリストとしての使用

// タスクリストを保存する
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: {
    content: "# プロジェクトリファクタリングのタスクリスト\n\n- [ ] 現在のアーキテクチャを分析する\n- [ ] パフォーマンスのボトルネックを特定する\n- [ ] 新しいコンポーネント構造を作成する\n- [ ] データ層の変更を実装する\n- [ ] UIコンポーネントを更新する\n- [ ] テストケースを作成する\n- [ ] ドキュメントを更新する"
  }
});

保存された情報の復元

// 新しい会話でリストを復元する
const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});

// 結果には以前保存されたリスト内容が含まれる

タスク進捗の更新

// 進捗を反映するためにノート内容を更新する
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: {
    content: "## アーキテクチャ分析完了\n\n重要な発見：\n- 現在の構造には循環依存がある\n- データ取得の効率が低い\n- コンポーネントの再利用性が低い\n\n提案：リポジトリパターンとコンポーネントコンビネーションを実装する",
    include_separator: true
  }
});

ノート内容のクリア

// タスク完了後にノートをクリアする
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

📚 ドキュメント

使用シーン

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

複雑なコーディングタスクを処理する際、Temp Notes は以下のことに役立ちます。

• タスクリストを保存する
• 各サブタスクの詳細な説明を含める
• チェックする必要のある具体的なファイルを記録する
• 複数の会話にまたがるタスクの進捗を追跡する

会話をまたがったコンテキストの保持

会話が長くなると、コンテキストウィンドウがいっぱいになることがあります。Temp Notes を使用すると、以下のことができます。

• 現在のタスクの状態を要約する
• 完了したステップと残りの作業を文書化する
• 後で参照するために重要な情報を保存する
• 新しい会話で続けるための次のステップを記録する

複数のリポジトリ間での情報転送

複数のリポジトリやプロジェクトを処理する際、Temp Notes は以下の用途に使用できます。

• あるリポジトリのコードスニペットを保存する
• 参照資料としてファイル内容を保存する
• あるプロジェクトから別のプロジェクトへのパターンや方法を文書化する
• 異なるプロジェクトをつなぐための一時的なドキュメントを作成する

協調作業フロー

複数のユーザーが協力する場合、Temp Notes は以下のことに役立ちます。

• タスク情報を中央集権的に保存する
• チームメンバーの作業進捗を共有する
• すべての参加者の情報を同期させる

設定説明

Temp Notes サーバーの設定情報は以下の通りです。

設定例

// Temp Notesサービスを初期化する
{
  "server_name": "temp-notes",
  "storage_path": "~/.mcp_config/",
  "encrypt_data": false
}

エラー処理

一般的なエラーと解決策

1. ノートファイルを開けない：
   • パスの権限が正しいことを確認する
   • 他のプロセスがファイルを使用していないことを確認する
2. 暗号化に失敗する：
   • 暗号化キーが正しいことを確認する
   • システムが必要な暗号化アルゴリズムをサポートしていることを確認する
3. 読み取り内容が空である：
   • 書き込み操作が正常に実行されたことを確認する
   • 意図しないクリア操作が行われていないことを確認する

セキュリティ上の注意事項

• データ暗号化：特に機密環境では、すべての保存内容を暗号化する必要があります。
• アクセス制御：Temp Notes サービスへのアクセス権限を制限し、不正アクセスを防ぎます。
• バックアップ戦略：データの損失を防ぐため、定期的にノートファイルをバックアップします。

アップグレードガイド

旧バージョンから新バージョンにアップグレードする際は、以下の点に注意してください。

• 設定パラメータの変更がないか確認する
• 互換性を確保し、必要に応じてクライアントコードを調整する
• アップグレードを実行する前に、データをバックアップする

APIドキュメント

Temp Notes は RESTful API を提供しており、開発者はカスタムアプリケーションに統合することができます。

内容の書き込み

POST /notes
Content-Type: text/plain

あなたのノート内容

内容の読み取り

GET /notes

内容のクリア

DELETE /notes

コマンドラインツールのリファレンス

使用例

// ヘルプ情報を表示する
mcp_temp_note --help

// ノートに内容を書き込む
mcp_temp_note write "あなたのノート内容"

// 現在のノート内容を読み取る
mcp_temp_note read

// ノート内容をクリアする
mcp_temp_note clear

📄 ライセンス

文書にライセンス情報は記載されていません。

連絡先

何か質問やフィードバックがある場合は、以下の方法で連絡してください。

• メール：support@temp-notes.com
• GitHub：https://github.com/temp-notes

⚠️ 重要提示

Temp Notes を使用する際は、関連する法令を遵守し、データの安全性とプライバシー保護を確保してください。