Zimi (Epheterson)

MCP文档知识

提供方 epheterson

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

Zimi是一个现代化的ZIM文件浏览器,提供丰富的Web界面、快速的JSON API和AI代理的MCP服务器,支持离线使用和多语言切换。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

离线浏览JavaScript本地部署多语言支持全文搜索知识管理Kiwix集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -v ./zims:/zims -v ./zimi-config:/config -p 8899:8899 epheterson/zimi

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 11 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

知识库读写

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

内容整理

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

选择建议

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

值得选的地方

  • 资料标注 11 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zimi (Epheterson)当前 11 stdio · 本地进程 本地部署 有 2026-05-17
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

服务器档案

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

详细介绍

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

齐米

为您的ZIM文件提供现代体验。

Kiwix 将世界知识打包成ZIM文件。Zimi通过丰富的web UI、快速的JSON API和用于AI代理的MCP服务器,让他们感觉像真正的互联网。一切都可以离线工作,用你的语言。

盒子里有什么

  • 跨源搜索。 使用片段和缩略图在所有来源上进行并行全文搜索。
  • 跨语言导航。 在语言之间切换文章并下载缺失的文章。
  • 发现。 每日更新卡片:今日图片、今日、引文、文字、书籍、目的地、谈话、漫画、国家。
  • 书签和历史。 感觉你在一个真正的浏览器中,保存你的位置。
  • Kiwix目录。 通过即时语言过滤下载10个类别的1000多个Kiwix档案。
  • 图书馆管理。 自动更新、密码保护、下载队列。
  • 收藏和收藏夹。 对源进行分组,以便于访问和范围搜索。
  • JSON API。 每个功能都可以通过令牌身份验证以编程方式访问。
  • 台式机和移动设备。 原生macOS和Python应用程序。部署到任何地方。

截图

文章阅读器

语言

不是事后的想法。语言深度融入了Zimi的各个方面,因此您可以专注于您的内容并有宾至如归的感觉。享受经过筛选的列表、标记的来源、RTL支持和无微不至的摇滚乐。

  • 10种语言。 英语、法语、德语、西班牙语、葡萄牙语、俄语、中文、阿拉伯语、印地语、希伯来语。

有什么不对吗? 打开一个问题。

安装

macOS```bash

brew tap epheterson/zimi && brew install --cask zimi


或从以下网址下载 GitHub 发布.

### Linux```bash
sudo snap install zimi

或者抓住 AppImage.

码头工人```bash

docker run -v ./zims:/zims -v ./zimi-config:/config -p 8899:8899 epheterson/zimi


`/zims` ZIM文件所在的位置。 `/config` 持久化缓存、索引和设置。打开http://localhost:8899.

Docker Compose```yaml
services:
zimi:
image: epheterson/zimi
container_name: zimi
restart: unless-stopped
ports:
- "8899:8899"
volumes:
- ./zims:/zims          # ZIM files go here
- ./zimi-config:/config  # cache, indexes, settings

python```bash

pip install zimi
ZIM_DIR=./zims zimi serve --port 8899


### 环境变量

|变量|默认值|描述|
|----------|---------|-------------|
| `ZIM_DIR` | `/zims` |ZIM文件的路径(已扫描 `*.zim` 启动时)|
| `ZIMI_DATA_DIR` | `/config` (Docker)或 `$ZIM_DIR/.zimi` |缓存、索引和设置。在Docker中单独挂载。 |
| `ZIMI_MANAGE` | `1` |图书馆管理员。 `0` 禁用。 |
| `ZIMI_MANAGE_PASSWORD` | _(无)_ |保护图书馆管理|
| `ZIMI_AUTO_UPDATE` | `0` |自动更新ZIM(`1` 启用)|
| `ZIMI_UPDATE_FREQ` | `weekly` | `daily`, `weekly`,或 `monthly` |
| `ZIMI_RATE_LIMIT` | `60` |请求/分钟/IP。 `0` 禁用。 |

## API

|端点|描述|
|----------|-------------|
| `GET /search?q=...&limit=5&zim=...&fast=1&lang=...` |全文搜索。 `fast=1` 仅适用于冠军赛。 `lang` 按语言过滤。 |
| `GET /read?zim=...&path=...&max_length=8000` |以纯文本形式阅读文章|
| `GET /suggest?q=...&limit=10&zim=...` |标题自动补全|
| `GET /list` |列出所有包含元数据的来源|
| `GET /article-languages?zim=...&path=...` |文章可用的所有语言|
| `GET /catalog?zim=...` |zimgit ZIMs的PDF目录|
| `GET /snippet?zim=...&path=...` |短文本片段|
| `GET /random?zim=...` |随机文章|
| `GET /collections` |列出收藏|
| `POST /collections` |创建/更新集合|
| `DELETE /collections?name=...` |删除收藏|
| `GET /resolve?url=...` |将外部URL解析为ZIM路径|
| `POST /resolve` |批量解析: `{"urls": [...]}` |
| `GET /health` |使用版本进行健康检查|
| `GET /w//` |提供生ZIM内容物|

### 例子```bash
# Search across all sources
curl "http://localhost:8899/search?q=python+asyncio&limit=5"

# Search in French only
curl "http://localhost:8899/search?q=eau&lang=fr&limit=5"

# Find all languages for an article
curl "http://localhost:8899/article-languages?zim=wikipedia&path=A/Water"

# Read an article
curl "http://localhost:8899/read?zim=wikipedia&path=A/Water_purification"

MCP服务器

Zimi包括一个用于AI代理的MCP服务器。```json
{
"mcpServers": {
"zimi": {
"command": "python3",
"args": ["-m", "zimi.mcp_server"],
"env": { "ZIM_DIR": "/path/to/zims" }
}
}
}


对于远程主机上的Docker:```json
{
"mcpServers": {
"zimi": {
"command": "ssh",
"args": ["your-server", "docker", "exec", "-i", "zimi", "python3", "-m", "zimi.mcp_server"]
}
}
}

工具: search (与 lang 过滤器), read, suggest, list_sources, random, article_languages, read_with_links, deep_search, list_collections, manage_collection, manage_favorites

贡献

看 贡献.md.

许可证

麻省理工学院


建于❤️ 加利福尼亚州by @以弗所生 和 克劳德代码.

常见问题

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

在客户端按下面的安装命令接入:docker run -v ./zims:/zims -v ./zimi-config:/config -p 8899:8899 epheterson/zimi。装完在客户端配置里引用同一个包或端点。

Zimi (Epheterson) 怎么在 Claude 里配置?

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

Zimi (Epheterson) 收费吗?

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

Zimi (Epheterson) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zimi (Epheterson) 支持哪些客户端?

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

Zimi (Epheterson) 能提供哪些能力?

资料显示约 11 个工具;能力标签包括 全文搜索、JavaScript、Claude、知识管理。具体工具清单以官方文档为准。

Zimi (Epheterson) 需要什么运行环境?

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

Zimi (Epheterson) 是本地还是远程?

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

热门专题

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

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