Kiwix Wiki MCP Server

Kiwix Wiki MCP服务器

这是一个模型上下文协议（MCP）服务器，通过Kiwix提供对离线维基百科和其他内容的访问。

先决条件

1. Kiwix服务器：您需要让Kiwix服务器在本地运行ZIM文件。

### 安装Kiwix服务器

   # On Ubuntu/Debian
   sudo apt-get install kiwix-tools

   # On macOS with Homebrew
   brew install kiwix-tools

   # Or download from https://www.kiwix.org/en/downloads/

1. ZIM文件：从以下网址下载ZIM格式的离线内容（如维基百科）https://library.kiwix.org/

### 示例：下载维基百科

   # Download a small version of Wikipedia (English)
   wget https://library.kiwix.org/content/wikipedia_en_top/2024-01/wikipedia_en_top_2024-01.zim

1. 启动Kiwix服务器:

   kiwix-serve --port=8080 --library wikipedia_en_top_2024-01.zim

服务器将可在以下位置访问http://localhost:8080

安装

1. 克隆或下载此项目
2. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

运行MCP服务器

npm start

或者直接运行：

node build/main.js

可用工具

1. search_wiki

在离线维基中搜索文章。

参数：

• query （必填）：wiki文章的搜索查询
• library （可选）：要搜索的库ID
• limit （可选）：最大结果数（默认值：10，最大值：50）

例子：

{
  "query": "artificial intelligence",
  "limit": 5
}

2. get_article

获取特定wiki文章的完整内容。

参数：

• url （必填）：维基文章的URL或路径
• library （可选）：库ID

例子：

{
  "url": "/A/Artificial_intelligence"
}

3. list_libraries

列出Kiwix中可用的脱机库。

参数： 无

配置

默认情况下，服务器在以下位置连接到Kiwix http://localhost:8080。您可以修改 KIWIX_SERVER_BASE 常数in main.ts 改变这一点。

故障排除

1. “搜索wiki失败”：确保Kiwix服务器在正确的端口上运行
2. “当前没有可用的库”：将ZIM文件添加到Kiwix服务器
3. 连接错误：验证配置中的Kiwix服务器URL和端口

MCP客户端配置示例

将此添加到MCP客户端配置中：

{
  "mcpServers": {
    "kiwix-wiki": {
      "command": "node",
      "args": ["/path/to/your/project/build/main.js"]
    }
  }
}

许可证

ISC许可证