knowledge-mcpCAUTION
Plain, structured thinking while you work. It's free, open, and local-first.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Plain, structured thinking while you work. It's free, open, and local-first.
knowledge-mcp brings the defined questions, conditions and connections from your knowledge base into your work with AI agents. Your agent applies the guidance based on your document and situation as you ask, write or review.
Under the hood, Knowledge Bus is used to codify domain knowledge as specs.
How it works
Features
- Structured Document context. You and your agent share each document's purpose, reader and questions.
- Guided writing. See each section's questions and catch missing answers while you write.
- Structure by folder. Set guidance for your whole knowledge base or for individual folders.
- Knowledge import. Turn notes and conversations into proposed updates to your documents.
- Document memory. Reuse saved document types and reader choices across sessions.
- Edit history. Compare original and revised text, and undo recorded edits.
- Custom guidance. Set and refine the questions and requirements for your documents.
Get started
On macOS, install with Homebrew:
brew install sterlingjf/tap/knowledge-mcp
Then register it with the apps you use:
c4fa283b7fe1OBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add knowledge-mcp -- npx -y [email protected]
{
"mcpServers": {
"knowledge-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (1)
1 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
kb_edits | read | arguments = respond.sent(location=location) |
Trust audit
CAUTIONgrade B · trust 82/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (1 observation(s))
- Shell
- declared (1 observation(s))
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (16)
knowledge_bus-0.10.0-py3-none-any.whl
knowledge_bus-0.10.0-py3-none-any.whl
knowledge_bus-0.10.0-py3-none-any.whl
knowledge_bus-0.10.0-py3-none-any.whl
knowledge_bus-0.10.0-py3-none-any.whl
if char in " \t\r\n":
.markdownlint-cli2.jsonc
.node-version
.oxlintrc.json
.pre-commit-config.yaml
.prettierignore
new URL("../../.github/workflows/release.yml", import.meta.url),const root = fileURLToPath(new URL("../../", import.meta.url));"../../runtime/skills/km-write/SKILL.md",
const root = fileURLToPath(new URL("../../", import.meta.url));Quit the old desktop app and remove each agent app's `knowledge-mcp` entry for `http://127.0.0.1:17952/mcp` before running `kb setup`. Setup refuses to overwrite a `knowledge-mcp` entry configured for
Gates applied: no_behavioural_pass.
c4fa283b7fe1full audit observations/trust-audit/mcp-server/sterlingjf__knowledge-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | c4fa283b7fe1 | CAUTION | B | 82 | first audit |
Questions
What is the knowledge-mcp MCP server?
Plain, structured thinking while you work. It's free, open, and local-first.
What tools does knowledge-mcp expose?
1 in total: 1 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is knowledge-mcp safe to connect to an agent?
With care. The audit graded it B (82/100) and found 16 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does knowledge-mcp need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (c4fa283b7fe1), read on 2026-10-12. The repository is watched and re-audited when it changes.