SilverBullet笔记管理

技能简介

本技能为SilverBullet笔记应用提供MCP服务器支持，通过标准化接口实现笔记的读取、写入、搜索和管理操作。SilverBullet是一款自托管的Markdown笔记系统，本技能将其功能封装为可调用工具。

业务背景

将自托管Markdown笔记系统转化为标准化服务接口，解决企业知识分散、检索困难、协作低效的问题。通过统一API实现笔记的集中管理、快速搜索和内容更新，让业务团队无需关心底层基础设施即可安全访问组织知识库。

落地案例：某咨询团队使用SilverBullet维护项目知识库。项目经理通过MCP接口列出所有客户方案页面，按关键词搜索历史案例，读取相关页面的完整内容参考过往经验。发现某方案需补充最新数据时，直接调用追加工具更新页面，无需登录后台或担心覆盖他人修改，确保知识实时同步。

能做什么

• 列出空间内所有文件和页面
• 读取指定页面的Markdown内容
• 创建新页面或更新现有页面
• 向页面追加内容而不覆盖原有数据
• 按名称模式搜索页面
• 获取页面元数据（修改时间、创建时间、权限）
• 检测服务器可用状态并获取配置信息

使用说明

安装步骤：

1. 执行安装命令：clawdhub install silverbullet
2. 或手动安装：进入技能目录后运行 uv venv && source .venv/bin/activate && uv pip install -e .
3. 设置环境变量：export SILVERBULLET_URL="http://localhost:3000"
4. 配置mcporter：在~/.mcporter/mcporter.json中添加服务器配置，指定Python路径、server.py位置及环境变量
5. 验证安装：mcporter list silverbullet应显示所有可用工具

基础调用示例：

• 列出页面：mcporter call silverbullet.list_files
• 读取页面：mcporter call silverbullet.read_page path:"index.md"
• 写入页面：mcporter call silverbullet.write_page path:"notes.md" content:"# 标题\n\n内容"
• 搜索页面：mcporter call silverbullet.search_pages query:"关键词"

输入与输出

见下方输入与输出表格。

风险提示

• 需确保SilverBullet服务已启动且网络可达，否则操作会失败
• 部分页面可能为只读权限，写入前建议先用get_page_metadata确认
• 删除操作不可逆，执行前请确认路径正确
• URL配置错误会导致所有工具调用超时或返回连接失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ramonitor/silverbullet-skill/SKILL.md
来源类型：GitHub仓库

常见问题

Q1：SilverBullet笔记管理 适合哪些场景？
A：适合需要「本技能为SilverBullet笔记应用提供MCP服务器支持，通过标准化」的场景，尤其是希望快速验证并落地的团队与个人。

Q2：第一次使用应该先做什么？
A：先明确目标任务，再按照页面中的“能做什么”和“使用说明”完成最小可行流程。

Q3：如何判断是否值得长期使用？
A：建议连续使用 1-2 周，对比效率、稳定性和协作成本，再决定是否纳入长期工具栈。

替代方案

• 本地文档搜索工具
• HackerNews提取器
• 科研助手安装

相关推荐

• 谷歌新闻采集
• GEO内容优化器
• Exa网络搜索
• 人员情报调研