Gistpad MCP

🚀 GistPad

GistPadは、GitHub GistsをベースにしたMCP（Multi - Platform Clipboard）サーバーです。ノート、日次摘要、その他のコンテンツを管理するための集中管理プラットフォームを提供し、これらの情報をGistsとして保存します。

🚀 クイックスタート

GistPadは、GitHub Gistsを利用したMCPサーバーで、ノートや日次摘要などのコンテンツを一元的に管理できます。以下に、インストールと使用方法を説明します。

✨ 主な機能

GistPadには、以下のような主な機能があります。

Gist管理

• すべてのGistsをリストする
  list_gists - すべてのGists（日次ノートとアーカイブ済みのGistsを除く）を取得します。

• 単一のGistを取得する
  get_gist - IDを指定して特定のGistの内容を取得します。

• 新しいGistを作成する
  create_gist - 説明と初期ファイル内容を指定して新しいGistを作成します。

• Gistを削除する
  delete_gist - IDを指定して特定のGistを削除します。

• Gistの説明を更新する
  update_gist_description - 特定のGistの説明情報を更新します。

• Gistを複製する
  duplicate_gist - すべてのファイルを含むGistの複製を作成します。

ファイル管理

• ファイル内容を更新する
  update_gist_file - 指定したGist内の特定のファイルの内容を更新します。

• 新しいファイルを追加する
  add_gist_file - 既存のGistに新しいファイルを追加します。

• ファイルを削除する
  delete_gist_file - Gistから特定のファイルを削除します。

• ファイルをリネームする
  rename_gist_file - Gist内の特定のファイルをリネームします。

日次ノート

• 日次ノートを取得/作成する
  get_todays_note - 今日の日次ノートを取得または作成します。

• 日次ノートの内容を更新する
  update_todays_note - 今日の日次ノートの内容を更新します。

• すべての日次ノートをリストする
  list_daily_notes - すべての日次ノートをリストします。

• 指定日のノートを取得する
  get_daily_note - 日付を指定して特定の日次ノートを取得します。

• 日次ノートを削除する
  delete_daily_note - 特定の日付の日次ノートを削除します。

お気に入りとアーカイブ管理

• すべてのお気に入りGistsをリストする
  list_starred_gists - すべてのお気に入りGistsを取得します。

• 特定のGistをお気に入りに登録する
  star_gist - 指定したIDのGistをお気に入りに登録します。

• 特定のGistのお気に入り登録を解除する
  unstar_gist - 特定のGistのお気に入り登録を解除します。

• すべてのアーカイブ済みGistsをリストする
  list_archived_gists - すべてのアーカイブ済みGistsを取得します。

• 特定のGistをアーカイブする
  archive_gist - 特定のGistをアーカイブします。

• 特定のGistのアーカイブを解除する
  unarchive_gist - 特定のGistのアーカイブを解除します。

コメント管理

• 特定のGistのすべてのコメントをリストする
  list_gist_comments - 指定したGistのすべてのコメントを取得します。

• 新しいコメントを追加する
  add_gist_comment - 指定したGistに新しいコメントを追加します。

• 既存のコメント内容を更新する
  edit_gist_comment - 特定のコメントの内容を更新します。

• 指定したコメントを削除する
  delete_gist_comment - 特定のコメントを削除します。

再利用可能なプロンプト

• 新しいプロンプトを追加する
  add_prompt - 新しい再利用可能なプロンプトをプロンプトセットに追加します。

• プロンプトを削除する
  delete_prompt - セットから指定したプロンプトを削除します。

📦 インストール

1. 依存関係のインストール

npm install --save-dev lodash.map

2. 環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

GIST_TOKEN=your_gist_token_here

📁 リソース管理

GistPadは、gist:/// URIスキームを通じてGistsをリソースとして公開することもサポートしています。これにより、MCPクライアントはツール操作を実行せずに直接Gistsを読み取ることができます。Gistに対する作成、読み取り、更新、削除操作を行うと、MCPクライアントにリソースリストが変更されたことが通知されます。

また、リソーステンプレートをサポートするMCPクライアントは、gist:///{gistId}/comments を使用して指定したGistのすべてのコメントを取得できます（list_gist_comments ツールを実行する必要はありません）。

リソース設定

アーカイブ済み、お気に入りのGistsまたは日次ノートをリソースとして公開したい場合は、MCPサーバーの設定に以下の内容を追加します。

{
  "expose_archived": true,
  "expose_starred": true,
  "expose_daily_notes": true
}

🎯 使用シナリオ

• 知識管理 - ノートや学習資料などをGistsとして保存し、管理と再利用を容易にします。
• タスク追跡 - 日次ノートを利用してタスクの進捗と待办事項を記録します。
• チーム協力 - Gistsを共有することで情報の同期と協力を行います。

📝 まとめ

GistPadは強力なMCPサーバーで、知識管理、タスク追跡、チーム協力に大きな便利をもたらします。柔軟な設定と豊富なAPIにより、様々な使用シナリオのニーズを満たすことができます。