📓 GistPad MCP

一个用于通过GitHub Gists管理并分享个人知识、日常笔记以及可复用提示的MCP服务器。它是GistPad VS Code扩展 和 GistPad.dev（适用于Web/移动设备）的伴侣，允许您从任何支持MCP的AI产品（例如GitHub Copilot、Claude Desktop）访问和编辑您的gists。

• 🏃 开始使用
• 🛠️ 包含工具
• 📁 包含资源
• 💬 可复用提示
• 💻 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配置文件中（或通过“添加MCP服务器”GUI/TUI）：

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

一旦您的客户端设置完毕，就可以开始享受gists + MCP的乐趣了！ 🥳 例如，尝试以下操作...

1. 探索内容

   • 我这个月编辑了多少个gists？
   • 我的<foo> gist的总结是什么？

2. 创建内容

   • 创建一个新的关于<foo>的gist
   • 更新我的<foo> gist，提到<bar>

3. 日常待办事项

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

4. 协作

   • 在<foo> gist上添加一条评论说<bar>
   • 给我一个<foo> gist的分享链接
   • 查看我收藏的gists

5. Gist组织

   • 归档我关于<foo>的gist
   • 向<bar> gist添加一个新的<foo>文件，并将<baz>的内容迁移到其中

6. 可复用提示

   • 创建一个新的提示，搜索指定的漫画系列并在网上提供其总结
   • 删除我关于<foo>的提示

🛠️ 包含工具

Gist管理

• list_gists - 列出所有您的gists（排除日常笔记和已归档的gists）。
• get_gist - 根据ID获取gist的内容。
• create_gist - 创建一个新的具有指定描述和初始文件内容的gist。
• delete_gist - 根据ID删除一个gist。
• update_gist_description - 更新一个gist的描述。
• duplicate_gist - 复制一个现有的gist及其所有文件。
• refresh_gists - 重新加载您的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 - 根据日期删除特定的日常笔记。

收藏

• list_starred_gists - 列出所有您收藏的gists。
• star_gist - 根据ID收藏一个特定的gist。
• unstar_gist - 根据ID取消收藏一个已收藏的gist。

归档

• list_archived_gists - 列出所有已归档的gists。
• archive_gist - 归档一个您的gist。
• unarchive_gist - 取消归档一个已归档的gist。

评论

• list_gist_comments - 列出特定gist的所有评论。
• add_gist_comment - 向gist添加一个新的评论。
• edit_gist_comment - 更新现有评论的内容。
• delete_gist_comment - 从gist中删除一个评论。

提示

• list_gist_prompts - 列出您提示集合中的提示。
• add_gist_prompt - 向您的提示集合添加一个新的提示。
• delete_ggist_prompt - 从您的集合中删除一个提示。

📁 包含资源

除了上述工具外，GistPad MCP服务器还将您的gists作为资源暴露（使用gist:///URI方案），允许客户端读取它们而无需执行工具。

当您添加/删除/复制一个gist，或者更改一个gist的描述时，将会向MCP客户端提供通知，表明资源列表已更改。如果您的MCP客户端支持资源订阅，则可以订阅特定的gist并在其更新时收到通知。

此外，对于支持资源模板的MCP客户端，GistPad还提供了gist:///{gistId}/comments资源，允许查询gist的评论（无需执行list_gist_comments工具）。

资源配置

如果您希望将已归档的gists、收藏的gists和/或日常笔记作为资源暴露，则只需更新您的MCP服务器配置，将--archived、--starred和/或--daily标志传递给gistpad-mcp CLI。

💬 可复用提示

GistPad允许您创建和管理存储在gist中的参数化/可复用提示，这些提示以markdown文件的形式存储。您可以使用add_prompt和delete_prompt工具来管理提示，只需请求您的MCP客户端创建/删除一个提示，指定您想要的内容/参数即可。

在后台，提示存储在一个名为💬 Prompts的gist中（该gist由add_prompt工具自动创建）。提示文件包括其提示作为正文，并可选地包括描述和参数使用front-matter。如果提示使用参数，提示的正文应包含{{argument}}占位符，当MCP客户端检索它时会被替换。

💻 CLI参考

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

• --archived - 在MCP资源列表中包含已归档的gists（注意：list_archived_gists工具始终可用）
• --starred - 在MCP资源列表中包含收藏的gists（注意：list_starred_gists工具始终可用）
• --daily - 在MCP资源列表中包含日常笔记（注意：list_daily_notes工具始终可用）
• --markdown - 过滤返回的gists列表，只包含由Markdown文件组成的gists。

🧰 故障排除

• <u>未看到您的gists列表中的某个gist？</u> GistPad MCP服务器缓存您的gist列表，并在以下情况下更新它：1) 您通过MCP服务器进行更改时，或 2) 每小时一次。然而，如果您使用外部客户端添加/编辑/删除了一个gist，您可能需要告诉GistPad MCP刷新自身（假设它尚未执行每小时一次的刷新）。您可以通过触发refresh_gists工具（例如，在VS Code Copilot聊天中运行#refresh_gists）来实现这一点。