← 返回 Skills 市场
ramonitor

SilverBullet API

作者 ramonitor · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
1735
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install silverbullet-skill
功能描述
MCP server for SilverBullet note-taking app - read, write, search, and manage markdown pages
安全使用建议
This skill appears to do what it says — it performs HTTP calls to a SilverBullet server and exposes standard file/read/write/search tools. Before installing: 1) Verify the SILVERBULLET_URL you will set (prefer a local or trusted host); the skill can read/write any pages accessible at that URL, so pointing it at an untrusted remote host risks exposing your notes. 2) Inspect server.py and the package contents (you already have them) and confirm you are comfortable running uv pip install -e . locally. 3) Be aware the SKILL.md asks you to add a mcporter entry in ~/.mcporter/mcporter.json and to export SILVERBULLET_URL — these are normal but note the registry metadata did not declare the env var (minor inconsistency). 4) If you run the demo or tests, do so against a test or local SilverBullet instance to avoid accidental modification of production notes. If you want greater assurance, run the package install in an isolated environment and review network traffic from the process while testing.
功能分析
Type: OpenClaw Skill Name: silverbullet-skill Version: 1.0.0 The skill provides an MCP server to interact with the SilverBullet note-taking application. All operations are confined to the SilverBullet REST API, primarily targeting `http://localhost:3000` by default, or a user-configured `SILVERBULLET_URL`. The installation script in `SKILL.md` performs standard Python package installation using `uv`. The `server.py` code uses `httpx` to make requests to the configured SilverBullet instance, offering tools to list, read, write, delete, and search pages. There is no evidence of data exfiltration to external endpoints, malicious execution (e.g., `curl|bash`), persistence mechanisms, obfuscation, or prompt injection attempts in `SKILL.md` or `README.md` designed to subvert the agent's behavior beyond its stated purpose. The capabilities are directly aligned with managing a note-taking application.
能力评估
Purpose & Capability
The name, description, SKILL.md examples, and server.py tools all map to SilverBullet REST endpoints (.fs, .ping, .config). Required binaries and tools referenced in SKILL.md (python/uv, mcporter) are appropriate for running an MCP server and the provided pyproject lists expected deps (mcp[cli], httpx).
Instruction Scope
Runtime instructions confine activity to installing the package, configuring mcporter, setting SILVERBULLET_URL, and running the server. The SKILL.md does not direct the agent to read unrelated files, harvest system credentials, or transmit data to third-party endpoints outside the configured SilverBullet URL.
Install Mechanism
This is an instruction-first skill with a script-based install (uv venv + uv pip install -e .). Installing creates a virtualenv and installs from PyPI (mcp, httpx). This is expected for a Python MCP server, but the install writes files locally and runs package installs — review before running. No downloads from unknown hosts or URL shorteners are present.
Credentials
The code reads a single environment variable (SILVERBULLET_URL) to determine the server address, which is proportionate. However, registry metadata lists no required env vars while SKILL.md and README instruct the user to set SILVERBULLET_URL — this mismatch is a minor inconsistency to be aware of.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide configuration. It suggests writing a mcporter entry (user-level config) which is appropriate for an MCP server integration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install silverbullet-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /silverbullet-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
SilverBullet MCP server skill initial release. - Adds MCP server integration for the SilverBullet note-taking app. - Supports reading, writing, searching, and managing markdown pages via mcporter tools. - Provides installation and configuration steps for ClawdHub and manual setups. - Documents usage examples for all available tools and natural language requests. - Includes troubleshooting tips and references the SilverBullet HTTP API.
元数据
Slug silverbullet-skill
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

SilverBullet API 是什么?

MCP server for SilverBullet note-taking app - read, write, search, and manage markdown pages. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1735 次。

如何安装 SilverBullet API?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install silverbullet-skill」即可一键安装,无需额外配置。

SilverBullet API 是免费的吗?

是的,SilverBullet API 完全免费(开源免费),可自由下载、安装和使用。

SilverBullet API 支持哪些平台?

SilverBullet API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 SilverBullet API?

由 ramonitor(@ramonitor)开发并维护,当前版本 v1.0.0。

💬 留言讨论