使用说明

本地维基百科

本地维基百科是一个MCP服务器，可以让你让维基百科离线——在快速一次性下载后搜索和阅读文章。

这就是为什么这很重要：

维基百科全文搜索
- 大多数MCP服务器只支持精确的标题匹配和基本的重定向处理。
- 因为本地维基百科在本地存储全文，所以您可以运行真正的全文搜索。
一次性下载后即使没有互联网也能继续工作
- 由于数据保存在本地，即使您离线，也可以搜索和阅读维基百科文章。
处理高搜索频率
- 没有网络API速率限制-尽可能多地迭代和优化您的搜索。
- 非常适合灵活解释查询和运行重复搜索的用例。
易于扩展，因为全文是本地的
- 有了整个语料库，其他MCP服务器上难以实现的功能在这里要容易得多。
  - 其他MCP服务器可能受到它们所依赖的web API的限制；本地维基百科不是。
- 例如，添加“获取随机文章”功能很简单。

此MCP服务器旨在与小型本地LLM很好地配对。即使在没有大型LLM的地方，你仍然可以灵活地搜索维基百科并检索信息。我们使用一种名为Gemma 3n E4B的紧凑型面向移动设备的模型对其进行了验证，即使在仅使用CPU的环境中，它也能快速运行。

为了让小LLM变得友好，我们做出了一些深思熟虑的选择：

此MCP服务器提供以下两个工具。

根据指定的标题灵活搜索文章并返回适当的结果。多种搜索策略被统一到一个工具中，以使LLM的工具使用简单。

搜索方法包括：

对于1和2，返回文章的主要部分（摘要）。对于3、4和5，最多返回20个结果。

还有一个启发式查询修复功能，以防LLM意外地将额外或无关的细节传递给工具。

从维基百科的指定语言版本中随机获取一篇文章。

一切都是用Docker Compose设置的。按照以下步骤操作。

确保已安装Docker和Docker Compose。

git clone https://github.com/soukouki/local-wikipedia.git
cd local-wikipedia
docker-compose up

首次运行时，将下载config.yaml中指定语言的维基百科数据并为其编制索引。这可能需要一段时间——日语大约需要几十分钟，英语大约需要几个小时。我们建议使用稳定的光纤连接进行下载。

安装完成后，MCP服务器将启动。默认情况下，它监听端口29423。连接方式如下：

{
  "servers": {
    "local-wikipedia": {
      "url": "http://localhost:29423"
    }
  }
}

本地维基百科使用官方维基百科转储数据进行页面和重定向，以及发布在拥抱脸FW/finewiki·拥抱脸上的数据集.

对于全文搜索，它使用PGroonga在日语和英语中提供快速、内存高效的搜索。