Wikipedia MCP Server

Wikipedia MCP 服务

一个模型上下文协议（MCP）服务，可从 Wikipedia 检索信息，为大语言模型（LLM）提供上下文。此工具可帮助 AI 助手从 Wikipedia 获取事实信息，以可靠来源为回答提供依据。

概述

Wikipedia MCP 服务通过标准化的模型上下文协议接口，提供对 Wikipedia 信息的实时访问。这样，大模型便能直接从 Wikipedia 获取准确且最新的信息，以改进回答。

验证方

功能

• 搜索 Wikipedia：查找与特定查询匹配的文章，并提供增强的诊断信息
• 检索文章内容：获取包含所有信息的完整文章文本
• 文章摘要：获取文章的简明摘要
• 提取章节：从文章中检索特定章节
• 发现链接：查找文章中指向相关主题的链接
• 相关主题：发现与特定文章相关的主题
• 多语言支持：运行服务时，通过指定 --language 或 -l 参数访问不同语言的 Wikipedia（例如，使用 wikipedia-mcp --language ta 访问泰米尔语 Wikipedia）。
• 国家/地区支持：使用直观的国家/地区代码（如 --country US、--country China 或 --country TW），而不必使用语言代码。系统会自动映射到相应的 Wikipedia 语言变体。
• 语言变体支持：支持中文繁体/简体（例如，简体中文使用 zh-hans，繁体中文使用 zh-tw）、塞尔维亚语文字（sr-latn、sr-cyrl）及其他地区变体。
• 可选缓存：使用 --enable-cache 缓存 API 响应，以提升性能
• 现代 MCP 传输支持：支持 stdio、http 和 streamable-http（兼容旧版 sse）。
• 可选 MCP 传输身份验证：使用 --auth-mode static 或 --auth-mode jwt 保护网络传输。
• 兼容 Google ADK：与 Google ADK Agent 及其他使用严格函数调用架构的 AI 框架完全兼容

安装

使用 pipx（推荐用于 Claude Desktop）

使用 pipx 安装是供 Claude Desktop 使用的最佳方式，它会将命令全局安装：

# Install pipx if you don't have it
pip install pipx
pipx ensurepath

# Install the Wikipedia MCP server
pipx install wikipedia-mcp

这样可确保 Claude Desktop 的 PATH 中包含 wikipedia-mcp 命令。

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 wikipedia-mcp：

npx -y @smithery/cli install @Rudra-ravi/wikipedia-mcp --client claude

从 PyPI 安装（替代方式）

你也可以直接从 PyPI 安装：

pip install wikipedia-mcp

注意：如果使用此方法后 Claude Desktop 出现连接问题，可能需要在配置中使用命令的完整路径。详情请参阅配置部分。

使用虚拟环境

# Create a virtual environment
python3 -m venv venv

# Activate the virtual environment
source venv/bin/activate

# Install the package
pip install git+https://github.com/rudra-ravi/wikipedia-mcp.git

从源码安装

# Clone the repository
git clone https://github.com/rudra-ravi/wikipedia-mcp.git
cd wikipedia-mcp

# Create a virtual environment
python3 -m venv wikipedia-mcp-env
source wikipedia-mcp-env/bin/activate

# Install in development mode
pip install -e .

用法

运行服务

# If installed with pipx
wikipedia-mcp

# If installed in a virtual environment
source venv/bin/activate
wikipedia-mcp

# Specify transport protocol (default: stdio)
wikipedia-mcp --transport stdio  # For Claude Desktop
wikipedia-mcp --transport http --host 0.0.0.0 --port 8080 --path /mcp
wikipedia-mcp --transport streamable-http --host 0.0.0.0 --port 8080 --path /mcp
wikipedia-mcp --transport sse    # Legacy compatibility transport

# Specify language (default: en for English)
wikipedia-mcp --language ja  # Example for Japanese
wikipedia-mcp --language zh-hans  # Example for Simplified Chinese
wikipedia-mcp --language zh-tw    # Example for Traditional Chinese (Taiwan)
wikipedia-mcp --language sr-latn  # Example for Serbian Latin script

# Specify country/locale (alternative to language codes)
wikipedia-mcp --country US        # English (United States)
wikipedia-mcp --country China     # Chinese Simplified
wikipedia-mcp --country Taiwan    # Chinese Traditional (Taiwan)  
wikipedia-mcp --country Japan     # Japanese
wikipedia-mcp --country Germany   # German
wikipedia-mcp --country france    # French (case insensitive)

# List all supported countries
wikipedia-mcp --list-countries

# Optional: Specify host/port/path for network transport (use 0.0.0.0 for containers)
wikipedia-mcp --transport http --host 0.0.0.0 --port 8080 --path /mcp

# Optional: Enable caching
wikipedia-mcp --enable-cache

# Optional: Use Personal Access Token to avoid rate limiting (403 errors)
wikipedia-mcp --access-token your_wikipedia_token_here

# Or set via environment variable
export WIKIPEDIA_ACCESS_TOKEN=your_wikipedia_token_here
wikipedia-mcp

# Optional: Secure incoming MCP network requests with static bearer token
wikipedia-mcp --transport http --auth-mode static --auth-token your_mcp_token --host 0.0.0.0 --port 8080

# Optional: Secure incoming MCP network requests with JWT validation
wikipedia-mcp --transport http --auth-mode jwt --auth-jwks-uri https://issuer/.well-known/jwks.json --auth-issuer https://issuer

# Security note: prefer http/streamable-http + auth-mode for exposed network transport.

# Combine options
wikipedia-mcp --country Taiwan --enable-cache --access-token your_wikipedia_token --transport http --path /mcp --port 8080

### Docker/Kubernetes

When running inside containers, bind the HTTP MCP server to all interfaces and map
the container port to the host or service:

```bash
# Build and run with Docker
docker build -t wikipedia-mcp .
docker run --rm -p 8080:8080 wikipedia-mcp --transport http --host 0.0.0.0 --port 8080 --path /mcp

Kubernetes 示例（最简）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: wikipedia-mcp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: wikipedia-mcp
  template:
    metadata:
      labels:
        app: wikipedia-mcp
    spec:
      containers:
        - name: server
          image: your-repo/wikipedia-mcp:latest
          args: ["--transport", "http", "--host", "0.0.0.0", "--port", "8080", "--path", "/mcp"]
          ports:
            - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: wikipedia-mcp
spec:
  selector:
    app: wikipedia-mcp
  ports:
    - name: http
      port: 8080
      targetPort: 8080

### Configuration for Claude Desktop

Add the following to your Claude Desktop configuration file:

**Option 1: Using command name (requires `wikipedia-mcp` to be in PATH)**
```json
{
  "mcpServers": {
    "wikipedia": {
      "command": "wikipedia-mcp"
    }
  }
}

选项 2：使用完整路径（遇到连接错误时推荐）

{
  "mcpServers": {
    "wikipedia": {
      "command": "/full/path/to/wikipedia-mcp"
    }
  }
}

选项 3：指定国家/语言

{
  "mcpServers": {
    "wikipedia-us": {
      "command": "wikipedia-mcp",
      "args": ["--country", "US"]
    },
    "wikipedia-taiwan": {
      "command": "wikipedia-mcp", 
      "args": ["--country", "TW"]
    },
    "wikipedia-japan": {
      "command": "wikipedia-mcp",
      "args": ["--country", "Japan"]
    }
  }
}

要查找完整路径，请运行：which wikipedia-mcp

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

注意：如果遇到连接错误，请参阅故障排除部分，了解解决方法。

文档索引

• CLI 用法和选项：参阅 docs/CLI.md
• API 和 MCP 工具/资源：参阅 docs/API.md
• 架构概览：参阅 docs/ARCHITECTURE.md
• 用户指南和故障排除：参阅 docs/USER_GUIDE.md
• 开发指南：参阅 docs/DEVELOPMENT.md
• 测试指南：参阅 docs/TESTING.md

可用的 MCP 工具

Wikipedia MCP 服务提供以下工具，供大模型与 Wikipedia 交互：

每个工具还提供了带 wikipedia_ 前缀的别名（例如，wikipedia_get_article），以便在不同服务之间更容易发现。

search_wikipedia

搜索与查询匹配的 Wikipedia 词条。

参数：

• query（字符串）：搜索词
• limit（整数，可选）：返回结果的最大数量（默认值：10）

返回：

• 包含标题、摘要片段和元数据的搜索结果列表

get_article

获取 Wikipedia 词条的完整内容。

参数：

• title（字符串）：Wikipedia 词条的标题

返回：

• 词条内容，包括正文、摘要、章节、链接和分类

get_summary

获取 Wikipedia 词条的简明摘要。

参数：

• title（字符串）：Wikipedia 词条的标题

返回：

• 词条的文本摘要

get_sections

获取 Wikipedia 词条的章节。

参数：

• title（字符串）：Wikipedia 词条的标题

返回：

• 包含各章节内容的结构化列表

get_links

获取 Wikipedia 词条中包含的链接。

参数：

• title（字符串）：Wikipedia 词条的标题

返回：

• 指向其他 Wikipedia 词条的链接列表

get_coordinates

获取 Wikipedia 词条的坐标。

参数：

• title（字符串）：Wikipedia 词条的标题

返回：

• 包含坐标信息的字典，包括：
  • title：词条标题
  • pageid：页面 ID
  • coordinates：坐标对象列表，包含纬度、经度和元数据
  • exists：词条是否存在
  • error：检索失败时显示的错误消息

get_related_topics

根据链接和分类，获取与 Wikipedia 词条相关的主题。

参数：

• title（字符串）：Wikipedia 词条的标题
• limit（整数，可选）：相关主题的最大数量（默认值：10）

返回：

• 包含相关度信息的相关主题列表

summarize_article_for_query

获取针对特定查询定制的 Wikipedia 词条摘要。

参数：

• title（字符串）：Wikipedia 词条的标题
• query（字符串）：摘要要聚焦的查询
• max_length（整数，可选）：摘要的最大长度（默认值：250）

返回：

• 包含标题、查询和聚焦摘要的字典

summarize_article_section

获取 Wikipedia 词条中特定章节的摘要。

参数：

• title（字符串）：Wikipedia 词条的标题
• section_title（字符串）：要总结的章节标题
• max_length（整数，可选）：摘要的最大长度（默认值：150）

返回：

• 包含标题、章节标题和章节摘要的字典

extract_key_facts

从 Wikipedia 条目中提取关键事实，也可以聚焦于条目中的特定主题。

参数：

• title（字符串）：Wikipedia 条目的标题
• topic_within_article（字符串，可选）：要聚焦提取事实的条目内特定主题
• count（整数，可选）：要提取的关键事实数量（默认：5）

返回值：

• 一个包含标题、主题和提取事实列表的字典

国家/地区支持

Wikipedia MCP 服务支持使用直观的国家和地区代码作为语言代码的替代项。这样无需了解语言代码，也能更方便地访问特定地区的 Wikipedia 内容。

支持的国家和地区

使用 --list-countries 查看所有受支持的国家和地区：

wikipedia-mcp --list-countries

这将按语言显示国家和地区，例如：

Supported Country/Locale Codes:
========================================
    en: US, USA, United States, UK, GB, Canada, Australia, ...
    zh-hans: CN, China
    zh-tw: TW, Taiwan  
    ja: JP, Japan
    de: DE, Germany
    fr: FR, France
    es: ES, Spain, MX, Mexico, AR, Argentina, ...
    pt: PT, Portugal, BR, Brazil
    ru: RU, Russia
    ar: SA, Saudi Arabia, AE, UAE, EG, Egypt, ...

使用示例

# Major countries by code
wikipedia-mcp --country US       # United States (English)
wikipedia-mcp --country CN       # China (Simplified Chinese)
wikipedia-mcp --country TW       # Taiwan (Traditional Chinese)
wikipedia-mcp --country JP       # Japan (Japanese)
wikipedia-mcp --country DE       # Germany (German)
wikipedia-mcp --country FR       # France (French)
wikipedia-mcp --country BR       # Brazil (Portuguese)
wikipedia-mcp --country RU       # Russia (Russian)

# Countries by full name (case insensitive)
wikipedia-mcp --country "United States"
wikipedia-mcp --country China
wikipedia-mcp --country Taiwan  
wikipedia-mcp --country Japan
wikipedia-mcp --country Germany
wikipedia-mcp --country france    # Case insensitive

# Regional variants
wikipedia-mcp --country HK       # Hong Kong (Traditional Chinese)
wikipedia-mcp --country SG       # Singapore (Simplified Chinese)
wikipedia-mcp --country "Saudi Arabia"  # Arabic
wikipedia-mcp --country Mexico   # Spanish

国家到语言的映射

服务会自动将国家代码映射到相应的 Wikipedia 语言版本：

• 英语国家和地区：US、UK、Canada、Australia、New Zealand、Ireland、South Africa → en
• 中文地区：
  • CN、China → zh-hans（简体中文）
  • TW、Taiwan → zh-tw（繁体中文——台湾）
  • HK、Hong Kong → zh-hk（繁体中文——香港）
  • SG、Singapore → zh-sg（简体中文——新加坡）
• 主要语言：JP→ja、DE→de、FR→fr、ES→es、IT→it、RU→ru 等
• 地区变体：支持 140 多个国家和地区

错误处理

如果指定了不受支持的国家或地区，系统会显示一条实用的错误消息：

$ wikipedia-mcp --country INVALID
Error: Unsupported country/locale: 'INVALID'. 
Supported country codes include: US, USA, UK, GB, CA, AU, NZ, IE, ZA, CN. 
Use --language parameter for direct language codes instead.

Use --list-countries to see supported country codes.

语言变体

Wikipedia MCP 服务支持具有多种书写系统或地区差异的语言变体。此功能尤其适用于中文、塞尔维亚语、库尔德语等具有多种文字或地区差异的语言。

支持的语言变体

中文变体

• zh-hans - 简体中文
• zh-hant - 繁体中文
• zh-tw - 繁体中文（台湾）
• zh-hk - 繁体中文（香港）
• zh-mo - 繁体中文（澳门）
• zh-cn - 简体中文（中国）
• zh-sg - 简体中文（新加坡）
• zh-my - 简体中文（马来西亚）

塞尔维亚语变体

• sr-latn - 塞尔维亚语拉丁字母
• sr-cyrl - 塞尔维亚语西里尔字母

库尔德语变体

• ku-latn - 库尔德语拉丁字母
• ku-arab - 库尔德语阿拉伯字母

挪威语变体

• no - 挪威语（自动映射为书面挪威语）

使用示例

# Access Simplified Chinese Wikipedia
wikipedia-mcp --language zh-hans

# Access Traditional Chinese Wikipedia (Taiwan)
wikipedia-mcp --language zh-tw

# Access Serbian Wikipedia in Latin script
wikipedia-mcp --language sr-latn

# Access Serbian Wikipedia in Cyrillic script
wikipedia-mcp --language sr-cyrl

语言变体的工作方式

指定 zh-hans 这样的语言变体时，服务会：

1. 将变体映射到 Wikipedia 的基础语言（例如，中文变体映射到 zh）
2. 使用基础语言连接 Wikipedia 服务的 API
3. 在 API 请求中加入变体参数，以获取特定变体的内容
4. 按照指定变体的规范返回格式化后的内容

此方法确保与 Wikipedia API 的兼容性，同时提供对特定变体内容和格式的访问。

示例提示词

服务启动并在 Claude Desktop 中完成配置后，你可以使用以下提示词：

常规 Wikipedia 查询：

• “使用 Wikipedia 信息介绍量子计算。”
• “根据 Wikipedia 总结人工智能的发展历史。”
• “Wikipedia 对气候变化有何介绍？”
• “查找与机器学习相关的 Wikipedia 条目。”
• “从 Wikipedia 获取神经网络条目的引言部分。”
• “埃菲尔铁塔的坐标是什么？”
• “从 Wikipedia 查找珠穆朗玛峰的纬度和经度。”
• “获取巴黎著名地标的坐标信息。”

使用特定国家和地区的维基百科：

• “在中国维基百科中搜索有关长城的信息。”（使用中文维基百科）
• “告诉我日文维基百科资料中关于东京的信息。”
• “德文维基百科对柏林墙有何介绍？”
• “从法文维基百科中查找有关埃菲尔铁塔的信息。”
• “获取台湾维基百科中关于台湾美食的条目。”

语言变体示例：

• “在繁体中文维基百科中搜索有关台湾的信息。”
• “查找有关现代中国的简体中文条目。”
• “从塞尔维亚语拉丁字母维基百科中获取有关贝尔格莱德的信息。”

MCP 资源

该服务还提供 MCP 资源（类似于 HTTP 端点，但适用于 MCP）：

• search/{query}：搜索与查询匹配的维基百科条目
• article/{title}：获取维基百科条目的完整内容
• summary/{title}：获取维基百科条目的摘要
• sections/{title}：获取维基百科条目的章节
• links/{title}：获取维基百科条目中的链接
• coordinates/{title}：获取维基百科条目的坐标
• summary/{title}/query/{query}/length/{max_length}：获取聚焦于查询内容的条目摘要
• summary/{title}/section/{section_title}/length/{max_length}：获取特定条目章节的摘要
• facts/{title}/topic/{topic_within_article}/count/{count}：从条目中提取关键事实

开发

本地开发环境设置

# Clone the repository
git clone https://github.com/rudra-ravi/wikipedia-mcp.git
cd wikipedia-mcp

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install the package in development mode
pip install -e .

# Install development and test dependencies
pip install -r requirements-dev.txt

# Run the server
wikipedia-mcp

项目结构

• wikipedia_mcp/：主包
  • __main__.py：包的入口点
  • server.py：MCP 服务实现
  • wikipedia_client.py：维基百科 API 客户端
  • api/：API 实现
  • core/：核心功能
  • utils/：实用函数
• tests/：测试套件
  • test_basic.py：基础包测试
  • test_cli.py：命令行界面测试
  • test_server_tools.py：全面的服务和工具测试

测试

项目包含全面的测试套件，以确保可靠性和功能正常。

测试结构

测试套件位于 tests/ 目录中，由以下测试文件组成：

• test_basic.py：基础包功能测试
• test_cli.py：命令行界面和传输测试
• test_server_tools.py：针对所有 MCP 工具和维基百科客户端功能的全面测试

运行测试

运行所有测试

# Install test dependencies
pip install -r requirements-dev.txt

# Run all tests
python -m pytest tests/ -v

# Run tests with coverage
python -m pytest tests/ --cov=wikipedia_mcp --cov-report=html

运行特定测试类别

# Run only unit tests (excludes integration tests)
python -m pytest tests/ -v -m "not integration"

# Run only integration tests (requires internet connection)
python -m pytest tests/ -v -m "integration"

# Run specific test file
python -m pytest tests/test_server_tools.py -v

测试类别

单元测试

• WikipediaClient 测试：针对所有客户端方法的模拟测试
  • 搜索功能
  • 条目获取
  • 摘要提取
  • 章节解析
  • 链接提取
  • 相关主题发现
• 服务测试：MCP 服务创建和工具注册
• CLI 测试：命令行界面功能

集成测试

• 真实 API 测试：实际调用维基百科 API 的测试
• 端到端测试：完整工作流测试

测试配置

项目使用 pytest.ini 进行测试配置：

[pytest]
markers =
    integration: marks tests as integration tests (may require network access)
    slow: marks tests as slow running

testpaths = tests
addopts = -v --tb=short

持续集成

所有测试都旨在：

• 在 CI/CD 环境中可靠运行
• 妥善处理网络故障
• 提供清晰的错误消息
• 覆盖边界情况和错误情形

添加新测试

贡献新功能时：

1. 为新功能添加单元测试
2. 同时包含成功和失败场景
3. 模拟外部依赖（维基百科 API）
4. 添加集成测试以进行端到端验证
5. 遵循现有的测试模式和命名约定

故障排除

常见问题

Claude Desktop 连接问题

问题：Claude Desktop 显示 spawn wikipedia-mcp ENOENT 等错误，或找不到命令。

原因：当 wikipedia-mcp 命令安装在用户专属的位置（例如 ~/.local/bin/），且该位置不在 Claude Desktop 的 PATH 中时，就会出现此问题。

解决方案：

1. 使用命令的完整路径（推荐）：

   {
     "mcpServers": {
       "wikipedia": {
         "command": "/home/username/.local/bin/wikipedia-mcp"
       }
     }
   }
   

   若要查找确切路径，请运行：which wikipedia-mcp

2. 使用 pipx 安装以供全局访问：

   pipx install wikipedia-mcp
   

   然后使用标准配置：

   {
     "mcpServers": {
       "wikipedia": {
         "command": "wikipedia-mcp"
       }
     }
   }
   

3. 在全局位置创建符号链接：

   sudo ln -s ~/.local/bin/wikipedia-mcp /usr/local/bin/wikipedia-mcp
   

其他问题

• 未找到文章：检查文章标题的拼写是否准确
• 速率限制：Wikipedia API 有速率限制；可考虑在请求之间添加延迟
• 文章过长：某些 Wikipedia 文章非常长，可能会超出令牌限制

搜索问题排查

如果搜索结果为空，请使用新的诊断工具：

1. 测试连接

使用 test_wikipedia_connectivity 工具检查是否可以访问 Wikipedia 的 API：

{
  "tool": "test_wikipedia_connectivity"
}

此工具会返回诊断信息，包括：

• 连接状态（success 或 failed）
• 响应时间（毫秒）
• 连接成功时的站点／主机信息
• 连接失败时的错误详情

2. 更详细的搜索错误信息

search_wikipedia 工具现在会返回详细的元数据：

{
  "tool": "search_wikipedia",
  "arguments": {
    "query": "Ada Lovelace",
    "limit": 10
  }
}

响应示例：

{
  "query": "Ada Lovelace",
  "results": [...],
  "count": 5,
  "status": "success",
  "language": "en"
}

未找到结果时，你会收到：

{
  "query": "nonexistent",
  "results": [],
  "status": "no_results",
  "count": 0,
  "language": "en",
  "message": "No search results found. This could indicate connectivity issues, API errors, or simply no matching articles."
}

3. 常见搜索问题及解决方案

• 结果为空：运行连接测试，确认查询拼写无误，并尝试使用更宽泛的词语。
• 连接错误：检查防火墙或代理设置，确保可以访问 *.wikipedia.org。
• API 限制：limit > 500 的请求会自动封顶；负值会重置为默认值（10）。

4. 使用详细日志进行调试

使用调试日志启动服务，以便深入了解问题：

wikipedia-mcp --log-level DEBUG

此操作会输出请求参数、响应状态代码，以及 API 返回的任何警告。

了解模型上下文协议（MCP）

模型上下文协议（MCP）不是传统的 HTTP API，而是一种用于大模型与外部工具通信的专用协议。其主要特点如下：

• 本地集成使用 stdio，网络集成使用可流式传输的 HTTP（为保持向后兼容，保留 sse）
• 专为 AI 模型交互设计
• 为工具、资源和提示词提供标准化格式
• 可直接与 Claude 及其他兼容 MCP 的 AI 系统集成

Claude Desktop 充当 MCP 客户端，而此服务提供 Claude 可用于访问 Wikipedia 信息的工具和资源。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解相关指南。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

联系作者

• 🌐 个人作品集：ravikumar-dev.me
• 📝 博客：Medium
• 💼 LinkedIn：in/ravi-kumar-e
• 🐦 Twitter：@Ravikumar_d3v