知识库服务器

Biblium是一个知识库服务器,通过Model Context Protocol为AI助手提供持久、可搜索的文档存储和检索功能。

  • by mipsou
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 mipsou/mcp-knowledge-base

使用说明

📚 圣经

你的人工智能个人图书馆。 一个知识库服务器,使Claude(或任何MCP客户端)能够存储、搜索和检索文档,这些文档被组织成您控制的集合。

🇬🇧 英语 | 🇫🇷 法语


🇬🇧 为什么是圣经?

LLM是强大的,但没有国家。圣经给他们 持久、可搜索的内存 通过 模型上下文协议.

将文档、笔记或任何文本放入命名集合中。Biblium使用BM25排名对所有内容进行索引,并使您的AI助手可以立即搜索到它。

是什么让它与众不同

  • 单二进制,3个直接deps --没有CGO,没有Python,没有Docker。SQLite通过 modernc.org/sqlite (C翻译成Go)。只需复制并运行。 参见go.mod.
  • 离线工作 -没有云服务,没有API密钥。您的数据保留在您的机器上。
  • 经批准的URL摄取 --建议添加网页;只有在您批准后,它们才会被提取并转换为降价。
  • 约17 MB二进制文件,约2600行Go代码 --小巧、可审计、可维护。

快速开始

# Install directly
go install github.com/mipsou/mcp-biblium/cmd/biblium@latest

# Or build from source
go build -o biblium ./cmd/biblium

# Run (starts MCP stdio server)
BIBLIUM_DATA_DIR=./my-knowledge biblium

添加 克劳德桌面版 (claude_desktop_config.json):

{
  "mcpServers": {
    "biblium": {
      "command": "/path/to/biblium",
      "env": {
        "BIBLIUM_DATA_DIR": "/path/to/data"
      }
    }
  }
}

具有单独数据目录的多个实例:

{
  "mcpServers": {
    "biblium-infra": {
      "command": "/path/to/biblium",
      "env": { "BIBLIUM_DATA_DIR": "/data/infra-docs" }
    },
    "biblium-dev": {
      "command": "/path/to/biblium",
      "env": { "BIBLIUM_DATA_DIR": "/data/dev-docs" }
    }
  }
}

然后问克劳德: “创建一个名为'golang'的集合,并添加我关于错误处理的注释。”

MCP工具

工具 它做什么
create_collection 创建新的知识集合
list_collections 列出所有收藏
add_document 将文档添加到集合
list_documents 列出集合中的文档
read_document 阅读文档内容
search 在所有收藏中进行全文搜索(BM25)
suggest_url 建议摄入URL(需要批准)
approve_url 批准并获取待处理的URL作为标记
list_pending 列出所有待定的URL建议

运作原理

graph TD
    A[Claude / MCP Client] -->|stdio JSON-RPC| B[Biblium]
    B --> C[FileStore<br/>docs/]
    B --> D[SQLite<br/>pending URLs]
    C --> E[BM25 Index<br/>in-memory]

集合作为磁盘上的目录存在。文档是纯文本文件。BM25索引在启动时从磁盘重建——没有单独的数据库可供搜索。

配置

变量 默认值 描述
BIBLIUM_DATA_DIR ~/biblium_data 藏品存放地点
BIBLIUM_SEARCH_BACKEND bm25 搜索引擎(bm25 或 ollama)
BIBLIUM_LOG_LEVEL info 日志冗长

交叉编译

无CGO意味着任何平台都可以轻松交叉编译:

GOOS=linux   GOARCH=amd64 go build -o biblium ./cmd/biblium
GOOS=linux   GOARCH=arm64 go build -o biblium ./cmd/biblium
GOOS=darwin  GOARCH=arm64 go build -o biblium ./cmd/biblium
GOOS=windows GOARCH=amd64 go build -o biblium.exe ./cmd/biblium
GOOS=freebsd GOARCH=amd64 go build -o biblium ./cmd/biblium
GOOS=openbsd GOARCH=amd64 go build -o biblium ./cmd/biblium

注: 由于上游错误,NetBSD amd64构建失败 modernc.org/sqlite.

许可证

EUPL-1.2或更高版本 --免费开源,与GPL、AGPL、MPL兼容。


🇫🇷 为什么是Biblium?

LLM功能强大,但没有内存。Biblium给了他们一个 持久和可搜索的记忆 通过le 模型上下文协议.

将文档、注释或文本放入命名集合中。Biblium以BM25排名对所有内容进行索引,并使您的人工智能助手可以立即访问内容。

区别在于

  • 一个二进制,3个直接DEP -没有CGO,没有Python,没有Docker。SQLite通过 modernc.org/sqlite (C以GO表示)。复制并启动。 参见go.mod.
  • 离线工作 -没有云服务,没有API密钥。您的数据将保留在您的机器上。
  • 获得认可的URL摄入 -提供网页;它们仅在验证后在Markdown中检索。
  • ~17 MB,~2600 GB行 --小巧、可审计、可维护。

快速启动

# Installer directement
go install github.com/mipsou/mcp-biblium/cmd/biblium@latest

# Ou compiler depuis les sources
go build -o biblium ./cmd/biblium

# Lancer (serveur MCP stdio)
BIBLIUM_DATA_DIR=./mes-connaissances biblium

添加到 克劳德桌面版 (claude_desktop_config.json) :

{
  "mcpServers": {
    "biblium": {
      "command": "/chemin/vers/biblium",
      "env": {
        "BIBLIUM_DATA_DIR": "/chemin/vers/data"
      }
    }
  }
}

具有单独目录的多个实例:

{
  "mcpServers": {
    "biblium-infra": {
      "command": "/chemin/vers/biblium",
      "env": { "BIBLIUM_DATA_DIR": "/data/docs-infra" }
    },
    "biblium-dev": {
      "command": "/chemin/vers/biblium",
      "env": { "BIBLIUM_DATA_DIR": "/data/docs-dev" }
    }
  }
}

然后问克劳德: “创建一个‘Golang’集合,并添加我的错误处理注释。»

MCP工具

工具 功能
create_collection 创建新集合
list_collections 列出所有集合
add_document 将文档添加到集合
list_documents 列出集合中的文档
read_document 阅读文档的内容
search 所有集合的全文搜索(BM25)
suggest_url 提供要接收的URL(需要批准)
approve_url 批准并检索Markdown中的URL
list_pending 列出挂起的URL

建筑

graph TD
    A[Claude / Client MCP] -->|stdio JSON-RPC| B[Biblium]
    B --> C[FileStore<br/>docs/]
    B --> D[SQLite<br/>URLs en attente]
    C --> E[Index BM25<br/>en mémoire]

集合是磁盘上的目录。文档是文本文件。BM25索引在启动时重建-没有单独的搜索基础。

配置

变量 缺陷 描述
BIBLIUM_DATA_DIR ~/biblium_data 存储目录
BIBLIUM_SEARCH_BACKEND bm25 搜索引擎(bm25 哦 ollama)
BIBLIUM_LOG_LEVEL info 日志级别

交叉编译

无CGO-任何平台的交叉编译:

GOOS=linux   GOARCH=amd64 go build -o biblium ./cmd/biblium
GOOS=linux   GOARCH=arm64 go build -o biblium ./cmd/biblium
GOOS=darwin  GOARCH=arm64 go build -o biblium ./cmd/biblium
GOOS=windows GOARCH=amd64 go build -o biblium.exe ./cmd/biblium
GOOS=freebsd GOARCH=amd64 go build -o biblium ./cmd/biblium
GOOS=openbsd GOARCH=amd64 go build -o biblium ./cmd/biblium

注: NetBSD amd64不编译,错误上游 modernc.org/sqlite.

许可证

EUPL-1.2-或更高版本 -免费开源,与GPL、AGPL和MPL兼容。