📓 GistPad MCP

📓 GistPad MCP

GitHub Gist を使って、個人のナレッジ、日々のメモ、再利用可能なプロンプトを管理・共有する MCP サーバーです。GistPad VS Code extension および GistPad.dev（ウェブ／モバイル向け）のコンパニオンで、MCP 対応の AI 製品（GitHub Copilot、Claude Desktop など）から Gist にアクセスして編集できます。

• 🏃 はじめに
• 🛠️ 付属ツール
• 📁 付属リソース
• 💬 再利用可能なプロンプト
• 💻 CLI リファレンス

🏃 はじめに

1. VS Code をお使いですか？

   1. GistPad extension をインストールし、VS Code を再読み込みします。

      注：VS Code 1.101.0 以降が必要です。古いバージョンをお使いの場合は、アップグレードしてください！

   2. GistPad タブを開き、GitHub アカウントでサインインします。これで、追加のセットアップやトークン管理なしで、Copilot チャットの Agent モードから GistPad を使い始められます 💪

2. その他の MCP クライアントの場合……

   1. gist スコープのみを含む個人用アクセストークンを生成します：https://github.com/settings/tokens/new

   2. クライアントの MCP 設定ファイルに以下と同等の設定を追加します（または、「Add MCP server」GUI／TUI から追加します）。

      {
        "mcpServers": {
          "gistpad": {
            "command": "npx",
            "args": ["-y", "gistpad-mcp"],
            "env": {
              "GITHUB_TOKEN": "<YOUR_PAT>"
            }
          }
        }
      }
      

クライアントのセットアップが完了したら、Gist と MCP を使い始めましょう！ 🥳 たとえば、次のように試してみてください……

1. コンテンツの確認

   • 今月、いくつの Gist を編集しましたか？
   • 私の <foo> Gist の概要を教えてください

2. コンテンツの作成

   • <foo> に関する新しい Gist を作成して
   • 私の <foo> Gist を更新して、<bar> を強調して

3. 毎日の ToDo

   • 今日、まだ完了していない ToDo は何ですか？
   • <foo> の新しい ToDo を追加して

4. 共同作業

   • <foo> Gist に「<bar>」というコメントを追加して
   • <foo> Gist の共有 URL を教えて
   • スターを付けた Gist を表示して

5. Gist の整理

   • <foo> に関する Gist をアーカイブして
   • <bar> Gist に新しい <foo> ファイルを追加して、<baz> の内容をそこに移して

6. 再利用可能なプロンプト

   • 指定した漫画シリーズについてウェブ検索し、その概要を提供する新しいプロンプトを作成して
   • <foo> に関する私のプロンプトを削除して

🛠️ 付属ツール

Gist の管理

• list_gists - 日々のメモとアーカイブ済みの Gist を除く、すべての Gist を一覧表示します。
• get_gist - ID で指定した Gist の内容を取得します。
• create_gist - 指定した説明と初期ファイル内容で新しい Gist を作成します。
• delete_gist - ID で指定した Gist を削除します。
• update_gist_description - ID で指定した Gist の説明を更新します。
• duplicate_gist - 既存の Gist の全ファイルを含むコピーを作成します。
• refresh_gists - キャッシュされたデータを無視して、Gist の一覧を再読み込みします。

ファイルの管理

• update_gist_file - Gist 内の特定のファイルの内容を更新します。
• add_gist_file - 既存の Gist に新しいファイルを追加します。
• delete_gist_file - Gist からファイルを削除します。
• rename_gist_file - Gist 内の既存のファイルの名前を変更します。
• edit_gist_file - Gist のファイルに対して、対象を絞った検索と置換による編集を行います。

コメント

• list_gist_comments - 指定した Gist のコメントをすべて一覧表示します。
• add_gist_comment - Gist に新しいコメントを追加します。
• edit_gist_comment - 既存のコメントの内容を更新します。
• delete_gist_comment - Gist からコメントを削除します。

🛠️ オプションのツール

ツールの範囲を最小限に保つため、以下のツールセットはデフォルトで無効になっています。対応する CLI フラグを渡すと有効になります。

デイリーノート（--daily）

• get_todays_note - 今日のデイリーノートを取得または作成します。
• update_todays_note - 今日のデイリーノートの内容を更新します。
• list_daily_notes - すべてのデイリーノートを一覧表示します。
• get_daily_note - 日付を指定して、特定のデイリーノートの内容を取得します。
• delete_daily_note - 日付を指定して、特定のデイリーノートを削除します。

スター登録（--starred）

• list_starred_gists - スター登録したすべての gist を一覧表示します。
• star_gist - ID を指定して、特定の gist をスター登録します。
• unstar_gist - ID を指定して、スター登録した gist のスターを解除します。

アーカイブ（--archived）

• list_archived_gists - アーカイブしたすべての gist を一覧表示します。
• archive_gist - gist をアーカイブします。
• unarchive_gist - アーカイブした gist をアーカイブ解除します。

プロンプト（--prompts）

• list_gist_prompts - プロンプトコレクション内のプロンプトを一覧表示します。
• add_gist_prompt - プロンプトコレクションに新しいプロンプトを追加します。
• delete_gist_prompt - コレクションからプロンプトを削除します。

📁 同梱リソース

上記のツールに加えて、GistPad MCP サーバーは gist をリソースとして公開します（gist:/// URI スキームを使用）。これにより、クライアントはツールを実行せずに gist を読み取れます。

gist の追加、削除、複製、または説明の変更を行うと、リソースの一覧が変更されたことを示す通知が MCP クライアントに送信されます。また、MCP クライアントがリソースのサブスクリプションに対応している場合は、特定の gist を購読して、更新時に通知を受け取れます。

さらに、リソーステンプレートに対応した MCP クライアント向けに、GistPad は gist:///{gistId}/comments のリソースも公開します。これにより、list_gist_comments ツールを実行せずに gist のコメントを照会できます。

リソースの設定

アーカイブした gist、スター登録した gist、デイリーノートのいずれか（または複数）をリソースとして公開するには、MCP サーバーの設定を更新し、gistpad-mcp CLI に --archived、--starred、--daily の各フラグを渡します。

💬 再利用可能なプロンプト

GistPad では、gist に Markdown ファイルとして保存される、パラメーター化された再利用可能なプロンプトを作成・管理できます。add_prompt および delete_prompt ツールを使ってプロンプトを管理できます。MCP クライアントに、指定した内容や引数でプロンプトを作成または削除するよう依頼するだけです。

内部では、プロンプトは 💬 Prompts という名前の gist に Markdown ファイルとして保存されます。この gist は add_prompt ツールによって自動的に作成されます。プロンプトファイルには、本文としてプロンプトが含まれ、必要に応じて front-matter で説明や引数を指定できます。プロンプトで引数を使用する場合、本文には {{argument}} プレースホルダーを含めます。このプレースホルダーは、MCP クライアントがプロンプトを取得するときに置き換えられます。

💻 CLI リファレンス

gistpad-mcp CLI では、次のオプションフラグを使用できます。

• --archived - アーカイブツールを有効にし、アーカイブした gist をリソースに含めます
• --starred - スター登録ツールを有効にし、スター登録した gist をリソースに含めます
• --daily - デイリーノートツールを有効にし、デイリーノートをリソースに含めます
• --prompts - プロンプトツールと MCP プロンプトハンドラーを有効にします
• --markdown - Markdown ファイルのみで構成された gist に絞り込みます

🧰 トラブルシューティング

• リストに gist が表示されませんか？ GistPad MCP サーバーは gist のリストをキャッシュし、1）MCP サーバー経由で変更を行ったとき、または 2）1 時間ごとに更新します。ただし、外部クライアントを使って gist を追加、編集、削除した場合、GistPad MCP に更新を指示する必要があることがあります（1 時間ごとの更新がまだ行われていない場合）。これを行うには、refresh_gists ツールを実行します（例：VS Code Copilot チャットで #refresh_gists を実行）。