📓 GistPad MCP

📓 GistPad MCP

一个用于通过 GitHub Gist 管理和分享个人知识、每日笔记及可重复使用提示词的 MCP 服务。它与 GistPad VS Code 扩展和 GistPad.dev（适用于 Web／移动设备）配合使用，让你能够通过任何支持 MCP 的 AI 产品（例如 GitHub Copilot、Claude Desktop）访问和编辑自己的 Gist。

• 🏃 开始使用
• 🛠️ 内置工具
• 📁 内置资源
• 💬 可重复使用的提示词
• 💻 CLI 参考

🏃 开始使用

1. 使用 VS Code？

   1. 安装 GistPad 扩展，然后重新加载 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”图形界面／终端界面添加）：

      {
        "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. 每日待办事项

   • 我今天有哪些尚未完成的待办事项？
   • 添加一个关于 <foo> 的新待办事项

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 资源，以便查询 gist 的评论（无需执行 list_gist_comments 工具）。

资源配置

如果你想将归档的 gist、收藏的 gist 和/或每日笔记作为资源公开，只需更新 MCP 服务配置，在 gistpad-mcp CLI 中传入 --archived、--starred 和/或 --daily 标志。

💬 可重复使用的提示词

GistPad 允许你创建和管理参数化/可重复使用的提示词，并将其作为 Markdown 文件存储在 gist 中。你可以使用 add_prompt 和 delete_prompt 工具管理提示词，只需让 MCP 客户端根据指定的内容/参数创建或删除提示词即可。

在后台，提示词会以 Markdown 文件的形式存储在名为 💬 Prompts 的 gist 中（该 gist 会由 add_prompt 工具自动创建）。提示词文件的正文即为提示词，也可以通过 front matter 添加描述和参数。如果提示词使用了参数，正文中应包含 {{argument}} 占位符；MCP 客户端获取提示词时会将其替换。

💻 CLI 参考

gistpad-mcp CLI 接受以下可选标志：

• --archived - 启用归档工具，并将归档的 gist 包含在资源中
• --starred - 启用收藏工具，并将收藏的 gist 包含在资源中
• --daily - 启用每日笔记工具，并将每日笔记包含在资源中
• --prompts - 启用提示词工具和 MCP 提示词处理程序
• --markdown - 将 gist 筛选为仅包含 Markdown 文件的 gist

🧰 故障排除

• 列表中没有看到某个 gist？ GistPad MCP 服务会缓存 gist 列表，并在以下情况下更新：1）你通过 MCP 服务进行任何更改时；或 2）每小时更新一次。不过，如果你使用外部客户端添加、编辑或删除 gist，可能需要让 GistPad MCP 刷新自身（前提是它尚未执行每小时刷新）。你可以触发 refresh_gists 工具来完成此操作（例如，在 VS Code Copilot 聊天中运行 #refresh_gists）。