名称： silverbullet
描述： 为 SilverBullet 笔记应用提供的 MCP 服务器 - 用于读取、写入、搜索和管理 Markdown 页面
主页： https://silverbullet.md
版本： 1.0.0
元数据：
clawdbot:
requires:
bins: ["python3", "uv"]
install:
- kind: script
label: "安装 SilverBullet MCP 服务器"
script: |
cd "$SKILL_DIR"
uv venv
source .venv/bin/activate
uv pip install -e .
允许工具： "mcporter(silverbullet:*)"

SilverBullet MCP 服务器

此技能提供了一个 MCP 服务器，用于与 SilverBullet 交互。SilverBullet 是一个基于 Markdown 的自托管笔记应用。

安装

通过 ClawdHub 安装

clawdhub install silverbullet

手动安装

cd ~/.clawdbot/skills/silverbullet
uv venv
source .venv/bin/activate
uv pip install -e .

配置

1. 设置 SilverBullet URL

export SILVERBULLET_URL="http://localhost:3000"

或者将其添加到你的 shell 配置文件（~/.zshrc / ~/.bashrc）中。

2. 配置 mcporter

在 ~/.mcporter/mcporter.json 中添加以下配置：

{
  "servers": {
    "silverbullet": {
      "command": "python",
      "args": ["{baseDir}/server.py"],
      "transport": "stdio",
      "env": {
        "SILVERBULLET_URL": "http://localhost:3000"
      }
    }
  }
}

请将 {baseDir} 替换为技能的实际路径（例如：~/.clawdbot/skills/silverbullet）。

3. 验证安装

mcporter list silverbullet

此命令应列出所有可用的工具。

可用工具

使用示例

列出所有页面

mcporter call silverbullet.list_files

读取页面

mcporter call silverbullet.read_page path:"index.md"
mcporter call silverbullet.read_page path:"journal/2024-01-15.md"

创建或更新页面

mcporter call silverbullet.write_page path:"notes/meeting.md" content:"# 会议记录\n\n- 事项 1\n- 事项 2"

向页面追加内容

mcporter call silverbullet.append_to_page path:"journal/today.md" content:"## 晚间更新\n\n项目已完成。"

搜索页面

mcporter call silverbullet.search_pages query:"meeting"

删除页面

mcporter call silverbullet.delete_page path:"drafts/old-note.md"

检查服务器状态

mcporter call silverbullet.ping_server

自然语言示例

配置完成后，你可以向 Moltbot 提问：

• “列出我所有的 SilverBullet 页面”
• “从 SilverBullet 读取我的索引页面”
• “创建一个名为‘项目想法’的新页面，并列出功能清单”
• “搜索名称中包含‘会议’的页面”
• “将今天的笔记追加到我的日志中”
• “我的 TODO 页面的最后修改日期是什么？”
• “我的 SilverBullet 服务器在运行吗？”

故障排除

服务器无响应

1. 检查 SilverBullet 是否正在运行：curl http://localhost:3000/.ping
2. 验证 SILVERBULLET_URL 是否设置正确
3. 检查防火墙/网络设置

权限被拒绝错误

SilverBullet 页面可能设置为只读。请检查 X-Permission 响应头或使用 get_page_metadata 工具来验证权限。

找不到工具

1. 验证 mcporter 配置：cat ~/.mcporter/mcporter.json
2. 直接测试服务器：python {baseDir}/server.py（应无错误启动）
3. 检查 Python/uv 安装：which python3 uv

API 参考

有关底层 REST API 的完整文档，请参阅 SilverBullet HTTP API。