Knowledge

MCP文档知识

提供方 未标注

文档知识 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

通过 AI 助手搜索、阅读和写入自托管的 Open Notebook 知识库。写入操作需要用户批准,且不会向其他任何地方发送数据。

一句话选型结论

按资料字段整理

Knowledge 属于文档知识类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
uvx knowledge-bundle-mcp --version

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Knowledge当前 未标注 stdio · 本地进程 本地部署 有 2026-11-20
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-11-20上游最后核验时间

详细介绍

10.6 KB
来自项目仓库与上游目录的原文,未做删改

Knowledge

Made by Seaynic Labs. Need tools like this built around your own systems? We do that.

Knowledge lets an AI assistant search, read and write the notes in your self-hosted Open Notebook, and comes with skills that teach it to do that work well: meeting notes, decision records, weekly reviews and source-backed research.

It is a bundle: tools, skills and instructions in one install. The tools are one server made of modules. You switch on the modules you use. New modules arrive switched off, so an update never changes what your assistant can do until you choose to.

Security card
Network Only the Open Notebook server you configure (KNOWLEDGE_OPEN_NOTEBOOK_URL). Open Notebook fetches the links you add, not Knowledge. Nothing else, no telemetry.
Files Reads its config file (~/.config/knowledge/config.toml). Reads a local file only when you name it in open_notebook_add_source, and only after you approve it (the file goes to your Open Notebook server). Writes one local approval log (~/.local/state/knowledge/approvals.jsonl).
Secrets API keys and passwords come from your environment or config file. They are never tool arguments and never returned to the model.
Read-only tools 6: open_notebook_notebooks, open_notebook_search, open_notebook_notes, open_notebook_note_get, open_notebook_source_get, knowledge_modules
Needs your approval open_notebook_note_create, open_notebook_add_source: you approve each write in your app, or pre-approve notebooks in settings (not for local files). The AI cannot approve for you.
Startup cost about 4,600 tokens (8 tools, 7 skill prompts)
Changes Tool descriptions are locked by hash (tool-manifest.lock.json); CI fails if they change silently.

Skills

Skill What it does Source
getting-started Checks the settings, runs the first calls, explains approvals and errors Seaynic Labs (MIT)
research-with-sources Answers from your notebooks, cites each claim, flags sources that disagree Seaynic Labs (MIT)
weekly-review Done, open and next-week items from the notes you changed this week Seaynic Labs (MIT)
meeting-notes Structured meeting notes as a Markdown file, optionally saved to a notebook Seaynic Labs (MIT)
decision-record A numbered Architecture Decision Record in a Decisions/ folder Seaynic Labs (MIT)
icm-architect Organises a knowledge base as a folder structure that agents can walk Jake Van Clief (MIT), credits
obsidian-markdown Obsidian-flavoured Markdown: wikilinks, callouts, properties Steph Ango (MIT), credits

Skills reach every app. Claude Code and other skill-aware apps read the skills/ folder. Any MCP app gets the same text as prompts: getting-started, for example, is the prompt named getting-started. Third-party skills keep their own license files. See CREDITS.md.

Install

Knowledge needs Python 3.11 or newer. With uv you don't install anything ahead of time:```bash
uvx knowledge-bundle-mcp --version


Or with pip:```bash
pip install knowledge-bundle-mcp

Pinned install. For a fixed setup, pin the exact version. The plugin manifest pins it the same way:```bash
uvx knowledge-bundle-mcp==0.2.1 --version


**As a Claude Code plugin.** One install gives you the MCP server and the skills. This needs the `seayniclabs/plugins` marketplace, which is published with the release:```
/plugin marketplace add seayniclabs/plugins
/plugin install knowledge@seayniclabs

The plugin still needs your Open Notebook address in its settings. The plugin file is .claude-plugin/plugin.json.

First five minutes

  1. Set KNOWLEDGE_OPEN_NOTEBOOK_URL to your server's address (step 2 below shows where).
  2. Run the check. It prints ok or FIX for each item and exits 0 when everything is ready:bash knowledge-bundle-mcp --doctor

  3. Start your assistant and ask it to list your notebooks. It calls open_notebook_notebooks and shows you the names.

  4. Ask it to search a word you know is in one of your notes. It calls open_notebook_search.
  5. Ask it to save a note. It shows a preview first, then asks you to approve the save in your app.

Settings

Set these as environment variables in your MCP client's config, or put them in a config file (see below). Knowledge starts without any of them and tells you what's missing when you call a tool.

Variable Module What it is
KNOWLEDGE_OPEN_NOTEBOOK_URL open_notebook Address of your Open Notebook server, e.g. https://notebook.example.com. No path.
KNOWLEDGE_OPEN_NOTEBOOK_PASSWORD open_notebook Only if your server has a password (OPEN_NOTEBOOK_PASSWORD on the server). Leave it unset otherwise.
KNOWLEDGE_OPEN_NOTEBOOK_REQUIRE_CONFIRM open_notebook true by default: you approve each new note and link. false lets the assistant save them on its own. Local files always need your approval.
KNOWLEDGE_OPEN_NOTEBOOK_ALLOWED_NOTEBOOKS open_notebook Optional. Comma-separated notebook names the assistant may save links and notes to without asking, e.g. Research,Inbox
KNOWLEDGE_APPROVAL_LOG any Optional. Where the approval log is written. Default: ~/.local/state/knowledge/approvals.jsonl
KNOWLEDGE__ENABLED any false turns a module off, e.g. KNOWLEDGE_OPEN_NOTEBOOK_ENABLED=false

Config file (optional). Knowledge also reads ~/.config/knowledge/config.toml, or the file named by KNOWLEDGE_CONFIG. Environment variables win over the file.```toml
[open_notebook]
url = "https://notebook.example.com"
password = "change-me"
require_confirm = true


## Add it to your MCP client

Most clients use the same JSON shape. Put it where your client keeps MCP servers:```json
{
  "mcpServers": {
    "knowledge": {
      "command": "uvx",
      "args": ["knowledge-bundle-mcp"],
      "env": {
        "KNOWLEDGE_OPEN_NOTEBOOK_URL": "https://notebook.example.com"
      }
    }
  }
}
Client Where the config goes
Claude Desktop claude_desktop_config.json (Settings → Developer → Edit Config)
Claude Code claude mcp add knowledge -- uvx knowledge-bundle-mcp, then add the env values, or a project .mcp.json
Cursor ~/.cursor/mcp.json, or .cursor/mcp.json in a project
VS Code .vscode/mcp.json, using "servers" instead of "mcpServers"
Sonique, Hermes, OpenClaw, others Any client that launches a stdio MCP server: command uvx, args ["knowledge-bundle-mcp"], plus the env values

Over HTTP. For clients that connect to a URL instead of launching a process:```bash
knowledge-bundle-mcp --transport http --port 8765


It serves streamable HTTP at `http://127.0.0.1:8765/mcp`. It listens only on your own machine by default. Put authentication in front of it before exposing it anywhere else.

## Try these

Paste any of these into your assistant once Knowledge passes `--doctor`:

1. "List my notebooks and tell me which one changed most recently."
2. "Search my notebooks for what I wrote about the Q3 budget, and cite each note."
3. "Write a weekly review of the notes I changed this week, using the weekly-review skill."
4. "Make an ADR for choosing SQLite over Postgres for the prototype, with the alternatives table filled in."
5. "Save this link to my Research notebook: https://example.com/article. Show me the preview first."

## Tools

| Tool | What it returns |
|---|---|
| `knowledge_modules` | Which modules are on, which settings are missing, the skills, and the publisher. Call this first. |
| `open_notebook_notebooks` | Your notebooks, most recently updated first, paged |
| `open_notebook_search` | Matching sources and notes. `mode` is `text` (keywords) or `vector` (meaning; needs an embedding model on the server). Optional `notebook_id`. Paged. |
| `open_notebook_notes` | The notes in one notebook, titles only, paged |
| `open_notebook_note_get` | One note's content, cut at `max_chars` |
| `open_notebook_source_get` | One source: title, topics, extracted text, notebooks, processing status |
| `open_notebook_note_create` | Saves a note after you approve it. Without `confirm=true` it only returns a preview. |
| `open_notebook_add_source` | Adds a web link, or a local file you name, as a source. Preview first; you approve it. Processed in the background. |

Every tool returns structured data with a published schema, so an assistant can work with the results instead of parsing text. Errors always look like `knowledge..:  Fix: `.

## Safety

- Knowledge only calls the Open Notebook server you configure. It sends nothing anywhere else and keeps no data of its own.
- `open_notebook_note_create` and `open_notebook_add_source` change your notebooks, so **you** approve each one. When the assistant asks to save, Knowledge asks you directly through your MCP client (MCP elicitation) and shows the notebook, the title and the full text or link. The assistant can't answer that question for you.
- A local file is read only after you name it, and it is uploaded only after you approve its full path and size. Files named like credential stores (`.env`, `.netrc`, private keys, `*.pem`, `*.key`) and files in `~/.ssh`, `~/.aws` or `~/.gnupg` are refused.
- Some MCP clients can't ask you questions yet. In those, Knowledge refuses to write unless you've pre-approved the notebook with `KNOWLEDGE_OPEN_NOTEBOOK_ALLOWED_NOTEBOOKS`, or turned approval off with `KNOWLEDGE_OPEN_NOTEBOOK_REQUIRE_CONFIRM=false`. Local files are never pre-approved.
- Before anything is written or sent, text that looks like a credential (API keys, tokens, private keys, passwords in URLs) is refused. The error names the kind of credential found, never the value.
- Use an `https://` address for your server, and give the password only to Knowledge, not to other tools.

## Develop```bash
uv venv && uv pip install -e '.[dev]'
.venv/bin/pytest
python3 scripts/check_skills.py
.venv/bin/python scripts/tool_lock.py --check
.venv/bin/python scripts/security_card.py --check

scripts/tool_lock.py (without --check) rewrites tool-manifest.lock.json after a deliberate change to a tool, prompt or instruction. Add a changelog line in the same commit.

Security

Report a vulnerability privately through GitHub (Security tab, "Report a vulnerability"). See SECURITY.md. Every approval, decline and refusal is logged locally in ~/.local/state/knowledge/approvals.jsonl: titles, notebook names and sizes, never the text. Set KNOWLEDGE_APPROVAL_LOG to move it.

License

MIT. Published by Seaynic Labs. Third-party skills are credited in CREDITS.md and keep their own licenses.


Built by Seaynic Labs. We build tools like this around a business's own systems: local-first, with a person approving every change. See custom integrations.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Knowledge 怎么安装?

在客户端按下面的安装命令接入:uvx knowledge-bundle-mcp --version。装完在客户端配置里引用同一个包或端点。

Knowledge 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Knowledge 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Knowledge 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Knowledge 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Cline、Gemini CLI;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Knowledge 能提供哪些能力?

资料显示能力标签包括 记忆。具体工具清单以官方文档为准。

Knowledge 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Knowledge 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-11-20。