🚀 GistPad
GistPad 是一个基于 GitHub Gists 的 MCP（多平台剪贴板）服务器，主要用于管理笔记、每日摘要及其他内容。它借助将信息存储为 Gists，提供了一个集中化的管理平台，能有效满足知识管理、任务跟踪和团队协作等多种需求。
🚀 快速开始
GistPad 是一个基于 GitHub Gists 的 MCP（Multi-Platform Clipboard）服务器，主要用于管理笔记、每日摘要以及其他内容。它通过将这些信息存储为 Gists 提供了一个集中化的管理平台。
✨ 主要特性
- 功能丰富：涵盖 Gist 管理、文件管理、每日笔记管理、关注与收藏、存档管理、评论管理以及可复用提示等多种功能。
- 资源管理便捷：支持通过
gist:///URI 方案将 Gists 曝露为资源，MCP 客户端可直接读取，操作变化会及时通知。 - 灵活配置：可在 MCP 服务器配置中选择将已存档、已关注的 Gists 或每日笔记一并曝露为资源。
- 多场景适用：适用于知识管理、任务跟踪和团队协作等多种场景。
📦 安装指南
1. 安装依赖
npm install --save-dev lodash.map
2. 配置环境变量
在项目根目录下创建一个 .env 文件，并添加以下内容：
GIST_TOKEN=your_gist_token_here
💻 使用示例
基础用法
# 以下是使用 GistPad 部分功能的示例代码（假设存在对应的 Python SDK）
# 列出所有 Gists
list_gists()
# 获取单个 Gist
get_gist(gist_id)
# 创建新 Gist
create_gist(description="New Gist", files={"file.txt": "Initial content"})
高级用法
# 以下是一些高级场景的示例代码
# 关注某个 Gist
star_gist(gist_id)
# 添加新评论到指定 Gist
add_gist_comment(gist_id, comment="This is a new comment.")
📚 详细文档
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 - 从集合中删除指定的提示。 |
资源管理
GistPad 还支持通过 gist:/// URI 方案将 Gists 曝露为资源，这使得 MCP 客户端能够在不执行工具操作的情况下直接读取它们。当你对 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，它能够满足多种不同的使用场景需求。