v2.47.0 · 18 MCP Tools · MIT

Your AI's Long-Term Memory.

跨项目知识库 MCP 服务。三层搜索架构：文本匹配 + TF-IDF + 多语言语义向量。让 AI Agent 拥有持久化、可检索、自进化的知识系统。

~ npx @dyyz1993/kb-mcp

$ npx @dyyz1993/kb-mcp --stdio
→ Loading knowledge base from ~/.knowledge/
→ MCP server ready (stdio mode)

$ npx @dyyz1993/kb-mcp --http --port 19877
→ HTTP server listening on :19877
→ Web UI: http://localhost:19877

Features

Built for AI Agents that need real memory.

不是简单的向量数据库。是专为 AI Agent 设计的知识管理系统——从存储、搜索到自进化，全链路覆盖。

三层搜索架构

P0 文本匹配 → P1 TF-IDF → P2 多语言语义向量。加权融合排序，越用越准。

18 个 MCP 工具

kb_write / kb_read / kb_search / kb_ask / kb_ingest_url / kb_ingest_repo… 覆盖知识全生命周期。

自进化闭环

kb_ask miss → Agent 联网搜索 → kb_ingest_url 存储 → 下次秒回。知识库自动增长。

双传输模式

Stdio（本地 MCP 零配置）+ HTTP（REST / SSE / StreamableHTTP）。一条命令切换。

Web UI 管理

Vite + React + Tailwind + Ant Design。知识库、智能问答、Chat 对话、内容工作台四合一。

多格式支持

Markdown / 代码 / URL 抓取 / GitHub 仓库分析。自动提取关键词、生成摘要、建立索引。

Screenshots

See it in action.

四标签页设计 + Dark / Light 双主题。真实截图，所见即所得。

Knowledge Base

document viewer · sidebar · search

Ask

smart Q&A

Chat

AI conversation

Content

content workshop

Light Mode

full theme support

Quick Start

One command. Zero config.

无需克隆仓库，无需安装依赖。NPX 直接运行。

Stdio 模式

bashterminal
# 一键启动
npx @dyyz1993/kb-mcp --stdio

HTTP 模式

bashterminal
# 启动 HTTP 服务
npx @dyyz1993/kb-mcp --http --port 19877
open http://localhost:19877

OpenCode / Claude / Cursor 配置

json~/.config/opencode/opencode.json
{
  "mcp": {
    "servers": {
      "knowledge-base": {
        "type": "local",
        "command": ["npx", "@dyyz1993/kb-mcp", "--stdio"]
      }
    }
  }
}

Architecture

Three-layer search engine.

从毫秒级文本匹配到深度语义理解。三层递进，加权融合。

文本匹配 < 1ms

即时全文检索，关键词命中。适合精确查找已知内容。

TF-IDF < 5ms

词频-逆文档频率。关键词加权排序，处理拼写变形和部分匹配。

语义向量 < 50ms

paraphrase-multilingual-MiniLM-L12-v2。跨语言语义检索，理解意图而非关键词。

18 MCP Tools

kb_writekb_readkb_searchkb_search_semantickb_list kb_deletekb_updatekb_outlinekb_recentkb_ask kb_ingest_urlkb_ingest_repokb_stale_checkkb_auto_linkkb_suggest file_readfile_grepfile_exists