内容
<div align="center">
```
██╗ ██╗ ██████╗ ██╗ ██╗████████╗ ██╗ ██╗██╗██╗ ██╗██╗ ██████╗ ██╗ ██╗
██║ ██║██╔════╝ ██║ ██║╚══██╔══╝ ██║ ██║██║██║ ██╔╝██║ ██╔════╝ ██║ ██║
██║ ██║██║ ███╗███████║ ██║ ██║ █╗ ██║██║█████╔╝ ██║ ██║ ██║ ██║
██║ ██║██║ ██║██╔══██║ ██║ ██║███╗██║██║██╔═██╗ ██║ ██║ ██║ ██║
███████╗██║╚██████╔╝██║ ██║ ██║ ╚███╔███╔╝██║██║ ██╗██║ ╚██████╗ ███████╗██║
╚══════╝╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚══╝╚══╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═════╝ ╚══════╝╚═╝
```
[](https://go.dev/dl/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/felixscode/light_wikipedia_cli/actions/workflows/golangci-lint.yml)
[](https://felixscode.github.io/light_wikipedia_cli)
**一个快速、轻量级的维基百科终端客户端 — 以及一个 MCP 服务器，供 AI 助手读取维基百科。**
[用法](#用法) | [快速入门](#快速入门) | [MCP 服务器](#mcp-服务器) | [文档](https://felixscode.github.io/light_wikipedia_cli) | [开发](#开发)
</div>
该项目编译为两个二进制文件，共享一个内部的维基媒体 REST API 客户端：
- **`wikipedia`** — 终端命令行工具，用于搜索、阅读和随机发现文章
- **`wikipedia-mcp`** — [MCP](https://modelcontextprotocol.io) 服务器，通过 stdio 为 AI 客户端提供服务
## 关于
我在早期编程生涯中创建了这个仓库。我使用函数式编程纯粹用 Python 编写了命令行工具。我主要将其与 bashrc 结合使用，在终端启动时渲染一个随机的维基百科文章。花了我大约一周的时间来构建。
2026 年，我偶然发现了这个项目，并问自己：我能否在一次提示中，以尽可能低的成本，将其重建为一个轻量级的 LLM-ready 命令行工具？我使用了 OpenRouter 上的 DeepSeek V4 Flash。第一次尝试，我就得到了一个可用的命令行工具和 MCP 服务器。我又添加了一个 TUI，耗时 2 次提示。又花了 3 次提示完成了 gh-pages 上的维基百科文档。我在 1.5 小时内完成了整个重写，API 成本为 1.10 美元。
## 快速入门
下载最新版本并使二进制文件可执行：
```sh
chmod +x wikipedia
wikipedia -r # 获取一个随机的文章摘要
```
## 用法
```sh
wikipedia # 随机文章摘要
wikipedia -s "Go 编程语言" # 搜索和阅读
wikipedia -s "Go" -f # 完整文章
wikipedia -l de -s "Go" # 其他语言
wikipedia --tui # 交互式 TUI
```
| 参数 | 短参数 | 描述 |
|------|-------|-------------|
| `--search` | `-s` | 搜索查询（默认为随机） |
| `--full` | `-f` | 显示完整文章 |
| `--lang` | `-l` | 语言代码（默认为 `en`） |
| `--random` | `-r` | 强制随机文章 |
| `--tui` | `-t` | 交互式 TUI |
| `--mcp` | | 作为 MCP 服务器运行 |
| `--no-color` | | 禁用 ANSI 颜色 |
需要 Go 1.26+ 来构建。构建 `bin/wikipedia` 和 `bin/wikipedia-mcp`。
## MCP 服务器
在您的 AI 客户端（Claude Code、Copilot、Continue 等）中配置：
```json
{
"mcpServers": {
"wikipedia": { "command": "/path/to/bin/wikipedia-mcp" }
}
}
```
## 文档
文档可在 [项目站点](https://felixscode.github.io/light_wikipedia_cli) 获取。包括命令行参考、MCP 设置、架构说明和 AI 代理开发指南。
## 许可证
MIT
