使用说明
📚 圣经
你的人工智能个人图书馆。 一个知识库服务器,使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兼容。
