用途
gistpad-mcp 是一个 MCP 服务器，用于通过 GitHub Gists 管理和共享个人知识、每日笔记与可复用提示词。它是 GistPad VS Code 扩展及 GistPad.dev（Web/移动端）的配套工具，旨在让用户从任何支持 MCP 的 AI 产品（例如 GitHub Copilot、Claude Desktop）中访问和编辑自己的 gists。
主要能力
- Gist 管理：列出、获取、创建、删除 gists；更新描述；复制 gist（含所有文件）；刷新缓存列表。
- 文件管理：更新、添加、删除、重命名 gist 内的文件；进行定向查找替换编辑。
- 评论管理：列出、添加、编辑、删除 gist 评论。
- 可选工具集（默认禁用，需通过 CLI 标志启用）：
- 每日笔记：获取/创建今日笔记、更新内容、列出所有每日笔记、按日期获取或删除笔记。
- 星标：列出星标 gists、加星、取消星标。
- 归档：列出归档 gists、归档、取消归档。
- 可复用提示词：列出、添加、删除提示词集合。
- 资源暴露：通过 gist:/// URI 方案将 gists 暴露为资源，客户端无需执行工具即可读取；支持资源订阅和资源模板（如 gist:///{gistId}/comments）。
- 通知：当 gist 列表发生变化时向 MCP 客户端发送通知。
使用方式
VS Code
- 安装 GistPad 扩展并重新加载 VS Code（需要 VS Code 1.101.0+）。
- 打开 GistPad 标签页并用 GitHub 账号登录。
- 之后即可在 Copilot 聊天（Agent 模式）中使用 GistPad，无需额外设置或令牌管理。
其他 MCP 客户端
- 生成仅包含 gist 范围的个人访问令牌：https://github.com/settings/tokens/new
- 在客户端的 MCP 配置文件中添加以下配置（或通过“Add MCP server” GUI/TUI）：
{
"mcpServers": {
"gistpad": {
"command": "npx",
"args": ["-y", "gistpad-mcp"],
"env": {
"GITHUB_TOKEN": "<YOUR_PAT>"
}
}
}
}
配置完成后，即可尝试类似以下操作：
- 探索内容：我这个月编辑了多少个 gist？我的 <foo> gist 的摘要是什么？
- 创建内容：创建一个关于 <foo> 的新 gist；更新我的 <foo> gist 以指出 <bar>。
- 每日待办：我今天未完成的待办有哪些？为 <foo> 添加一个新待办。
- 协作：在 <foo> gist 中添加评论说 <bar>；给我 <foo> gist 的分享链接；查看我加星的 gists。
- Gist 整理：归档我关于 <foo> 的 gist；在 <bar> gist 中添加新的 <foo> 文件并将 <baz> 内容迁移进去。
- 可复用提示词：创建一个新提示词，搜索指定漫画系列并提供摘要；删除我关于 <foo> 的提示词。
适用场景
- 在 AI 辅助下管理个人知识库和笔记。
- 通过自然语言快速创建、更新和整理 GitHub Gists。
- 管理每日待办和每日笔记。
- 在团队或社区中通过评论和分享链接协作。
- 创建可参数化的可复用提示词，存储于 gist 中。
限制与注意事项
- GistPad MCP 服务器会缓存 gist 列表，并在通过 MCP 服务器进行更改时或每小时更新。如果使用外部客户端添加/编辑/删除 gist，可能需要手动触发 refresh_gists 工具（例如在 VS Code Copilot 聊天中运行 #refresh_gists）来刷新。
- 部分工具集默认禁用，需通过 CLI 标志启用：--archived、--starred、--daily、--prompts、--markdown。
- 可复用提示词以 Markdown 文件形式存储在一个名为 💬 Prompts 的 gist 中（由 add_gist_prompt 工具自动创建）。提示词文件包含正文、可选的描述和参数（通过 front-matter），正文中可使用 {{argument}} 占位符，在 MCP 客户端获取时替换。
- 使用其他 MCP 客户端时需要生成仅含 gist 范围的个人访问令牌。
