Wikipedia MCP Server

A Model Context Protocol (MCP) server that retrieves information from Wikipedia to provide context to Large Language Models (LLMs). This tool helps AI assistants access factual information from Wikipedia to ground their responses in reliable sources.

Overview

The Wikipedia MCP server provides real-time access to Wikipedia information through a standardized Model Context Protocol interface. This allows LLMs to retrieve accurate and up-to-date information directly from Wikipedia to enhance their responses.

Verified By

Features

Search Wikipedia: Find articles matching specific queries with enhanced diagnostics
Retrieve Article Content: Get full article text with all information
Article Summaries: Get concise summaries of articles
Section Extraction: Retrieve specific sections from articles
Link Discovery: Find links within articles to related topics
Related Topics: Discover topics related to a specific article
Multi-language Support: Access Wikipedia in different languages by specifying the --language or -l argument when running the server (e.g., wikipedia-mcp --language ta for Tamil).
Country/Locale Support: Use intuitive country codes like --country US, --country China, or --country TW instead of language codes. Automatically maps to appropriate Wikipedia language variants.
Language Variant Support: Support for language variants such as Chinese traditional/simplified (e.g., zh-hans for Simplified Chinese, zh-tw for Traditional Chinese), Serbian scripts (sr-latn, sr-cyrl), and other regional variants.
Optional caching: Cache API responses for improved performance using --enable-cache
Google ADK Compatibility: Fully compatible with Google ADK agents and other AI frameworks that use strict function calling schemas

Installation

Using pipx (Recommended for Claude Desktop)

The best way to install for Claude Desktop usage is with pipx, which installs the command globally:

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

# Install the Wikipedia MCP server
pipx install wikipedia-mcp

This ensures the wikipedia-mcp command is available in Claude Desktop's PATH.

Installing via Smithery

To install wikipedia-mcp for Claude Desktop automatically via Smithery:

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

From PyPI (Alternative)

You can also install directly from PyPI:

pip install wikipedia-mcp

Note: If you use this method and encounter connection issues with Claude Desktop, you may need to use the full path to the command in your configuration. See the Configuration section for details.

Using a virtual environment

# 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

From source

# 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 .

Usage

Running the server

# 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 sse    # For HTTP streaming

# 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 for SSE (use 0.0.0.0 for containers)
wikipedia-mcp --transport sse --host 0.0.0.0 --port 8080

# 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

# Security note for SSE: The transport does not define built-in endpoint authentication.
# To restrict access, run the server behind an authenticating reverse proxy (e.g., Nginx/Traefik),
# or expose it only on a private network/VPN and use firewall rules.

# Combine options
wikipedia-mcp --country Taiwan --enable-cache --access-token your_token --transport sse --port 8080

### Docker/Kubernetes

When running inside containers, bind the SSE 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 sse --host 0.0.0.0 --port 8080

Kubernetes example (minimal):

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", "sse", "--host", "0.0.0.0", "--port", "8080"]
          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"
    }
  }
}

Option 2: Using full path (recommended if you get connection errors)

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

Option 3: With country/language specification

{
  "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"]
    }
  }
}

To find the full path, run: which wikipedia-mcp

Configuration file locations:

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

Note: If you encounter connection errors, see the Troubleshooting section for solutions.

Documentation Index

CLI usage and options: see docs/CLI.md
API and MCP tools/resources: see docs/API.md
Architecture overview: see docs/ARCHITECTURE.md
User guide and troubleshooting: see docs/USER_GUIDE.md
Development guide: see docs/DEVELOPMENT.md
Testing guide: see docs/TESTING.md

Available MCP Tools

The Wikipedia MCP server provides the following tools for LLMs to interact with Wikipedia:

`search_wikipedia`

Search Wikipedia for articles matching a query.

Parameters:

query (string): The search term
limit (integer, optional): Maximum number of results to return (default: 10)

Returns:

A list of search results with titles, snippets, and metadata

`get_article`

Get the full content of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

Article content including text, summary, sections, links, and categories

`get_summary`

Get a concise summary of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A text summary of the article

`get_sections`

Get the sections of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A structured list of article sections with their content

`get_links`

Get the links contained within a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A list of links to other Wikipedia articles

`get_coordinates`

Get the coordinates of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A dictionary containing coordinate information including:
- title: The article title
- pageid: The page ID
- coordinates: List of coordinate objects with latitude, longitude, and metadata
- exists: Whether the article exists
- error: Any error message if retrieval failed

`get_related_topics`

Get topics related to a Wikipedia article based on links and categories.

Parameters:

title (string): The title of the Wikipedia article
limit (integer, optional): Maximum number of related topics (default: 10)

Returns:

A list of related topics with relevance information

`summarize_article_for_query`

Get a summary of a Wikipedia article tailored to a specific query.

Parameters:

title (string): The title of the Wikipedia article
query (string): The query to focus the summary on
max_length (integer, optional): Maximum length of the summary (default: 250)

Returns:

A dictionary containing the title, query, and the focused summary

`summarize_article_section`

Get a summary of a specific section of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article
section_title (string): The title of the section to summarize
max_length (integer, optional): Maximum length of the summary (default: 150)

Returns:

A dictionary containing the title, section title, and the section summary

`extract_key_facts`

Extract key facts from a Wikipedia article, optionally focused on a specific topic within the article.

Parameters:

title (string): The title of the Wikipedia article
topic_within_article (string, optional): A specific topic within the article to focus fact extraction
count (integer, optional): Number of key facts to extract (default: 5)

Returns:

A dictionary containing the title, topic, and a list of extracted facts

Country/Locale Support

The Wikipedia MCP server supports intuitive country and region codes as an alternative to language codes. This makes it easier to access region-specific Wikipedia content without needing to know language codes.

Supported Countries and Regions

Use --list-countries to see all supported countries:

wikipedia-mcp --list-countries

This will display countries organized by language, for example:

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, ...

Usage Examples

# 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

Country-to-Language Mapping

The server automatically maps country codes to appropriate Wikipedia language editions:

English-speaking: US, UK, Canada, Australia, New Zealand, Ireland, South Africa → en
Chinese regions:
- CN, China → zh-hans (Simplified Chinese)
- TW, Taiwan → zh-tw (Traditional Chinese - Taiwan)
- HK, Hong Kong → zh-hk (Traditional Chinese - Hong Kong)
- SG, Singapore → zh-sg (Simplified Chinese - Singapore)
Major languages: JP→ja, DE→de, FR→fr, ES→es, IT→it, RU→ru, etc.
Regional variants: Supports 140+ countries and regions

Error Handling

If you specify an unsupported country, you'll get a helpful error message:

$ 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.

Language Variants

The Wikipedia MCP server supports language variants for languages that have multiple writing systems or regional variations. This feature is particularly useful for Chinese, Serbian, Kurdish, and other languages with multiple scripts or regional differences.

Supported Language Variants

Chinese Language Variants

zh-hans - Simplified Chinese
zh-hant - Traditional Chinese
zh-tw - Traditional Chinese (Taiwan)
zh-hk - Traditional Chinese (Hong Kong)
zh-mo - Traditional Chinese (Macau)
zh-cn - Simplified Chinese (China)
zh-sg - Simplified Chinese (Singapore)
zh-my - Simplified Chinese (Malaysia)

Serbian Language Variants

sr-latn - Serbian Latin script
sr-cyrl - Serbian Cyrillic script

Kurdish Language Variants

ku-latn - Kurdish Latin script
ku-arab - Kurdish Arabic script

Norwegian Language Variants

no - Norwegian (automatically mapped to Bokmål)

Usage Examples

# 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

How Language Variants Work

When you specify a language variant like zh-hans, the server:

Maps the variant to the base Wikipedia language (e.g., zh for Chinese variants)
Uses the base language for API connections to the Wikipedia servers
Includes the variant parameter in API requests to get content in the specific variant
Returns content formatted according to the specified variant's conventions

This approach ensures optimal compatibility with Wikipedia's API while providing access to variant-specific content and formatting.

Example Prompts

Once the server is running and configured with Claude Desktop, you can use prompts like:

General Wikipedia queries:

"Tell me about quantum computing using the Wikipedia information."
"Summarize the history of artificial intelligence based on Wikipedia."
"What does Wikipedia say about climate change?"
"Find Wikipedia articles related to machine learning."
"Get me the introduction section of the article on neural networks from Wikipedia."
"What are the coordinates of the Eiffel Tower?"
"Find the latitude and longitude of Mount Everest from Wikipedia."
"Get coordinate information for famous landmarks in Paris."

Using country-specific Wikipedia:

"Search Wikipedia China for information about the Great Wall." (uses Chinese Wikipedia)
"Tell me about Tokyo from Japanese Wikipedia sources."
"What does German Wikipedia say about the Berlin Wall?"
"Find information about the Eiffel Tower from French Wikipedia."
"Get Taiwan Wikipedia's article about Taiwanese cuisine."

Language variant examples:

"Search Traditional Chinese Wikipedia for information about Taiwan."
"Find Simplified Chinese articles about modern China."
"Get information from Serbian Latin Wikipedia about Belgrade."

MCP Resources

The server also provides MCP resources (similar to HTTP endpoints but for MCP):

search/{query}: Search Wikipedia for articles matching the query
article/{title}: Get the full content of a Wikipedia article
summary/{title}: Get a summary of a Wikipedia article
sections/{title}: Get the sections of a Wikipedia article
links/{title}: Get the links in a Wikipedia article
coordinates/{title}: Get the coordinates of a Wikipedia article
summary/{title}/query/{query}/length/{max_length}: Get a query-focused summary of an article
summary/{title}/section/{section_title}/length/{max_length}: Get a summary of a specific article section
facts/{title}/topic/{topic_within_article}/count/{count}: Extract key facts from an article

Development

Local Development Setup

# 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

Project Structure

wikipedia_mcp/: Main package
- __main__.py: Entry point for the package
- server.py: MCP server implementation
- wikipedia_client.py: Wikipedia API client
- api/: API implementation
- core/: Core functionality
- utils/: Utility functions
tests/: Test suite
- test_basic.py: Basic package tests
- test_cli.py: Command-line interface tests
- test_server_tools.py: Comprehensive server and tool tests

Testing

The project includes a comprehensive test suite to ensure reliability and functionality.

Test Structure

The test suite is organized in the tests/ directory with the following test files:

test_basic.py: Basic package functionality tests
test_cli.py: Command-line interface and transport tests
test_server_tools.py: Comprehensive tests for all MCP tools and Wikipedia client functionality

Running Tests

Run All Tests

# 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 Specific Test Categories

# 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

Test Categories

Unit Tests

WikipediaClient Tests: Mock-based tests for all client methods
- Search functionality
- Article retrieval
- Summary extraction
- Section parsing
- Link extraction
- Related topics discovery
Server Tests: MCP server creation and tool registration
CLI Tests: Command-line interface functionality

Integration Tests

Real API Tests: Tests that make actual calls to Wikipedia API
End-to-End Tests: Complete workflow testing

Test Configuration

The project uses pytest.ini for test configuration:

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

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

Continuous Integration

All tests are designed to:

Run reliably in CI/CD environments
Handle network failures gracefully
Provide clear error messages
Cover edge cases and error conditions

Adding New Tests

When contributing new features:

Add unit tests for new functionality
Include both success and failure scenarios
Mock external dependencies (Wikipedia API)
Add integration tests for end-to-end validation
Follow existing test patterns and naming conventions

Troubleshooting

Common Issues

Claude Desktop Connection Issues

Problem: Claude Desktop shows errors like spawn wikipedia-mcp ENOENT or cannot find the command.

Cause: This occurs when the wikipedia-mcp command is installed in a user-specific location (like ~/.local/bin/) that's not in Claude Desktop's PATH.

Solutions:

Use full path to the command (Recommended):

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

To find your exact path, run: which wikipedia-mcp

Install with pipx for global access:

pipx install wikipedia-mcp

Then use the standard configuration:

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

Create a symlink to a global location:

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

Other Issues

Article Not Found: Check the exact spelling of article titles
Rate Limiting: Wikipedia API has rate limits; consider adding delays between requests
Large Articles: Some Wikipedia articles are very large and may exceed token limits

Troubleshooting Search Issues

If you're experiencing empty search results, use the new diagnostic tools:

1. Test Connectivity

Use the test_wikipedia_connectivity tool to check if you can reach Wikipedia's API:

{
  "tool": "test_wikipedia_connectivity"
}

This returns diagnostics including:

Connection status (success or failed)
Response time in milliseconds
Site/host information when successful
Error details when connectivity fails

2. Enhanced Search Error Information

The search_wikipedia tool now returns detailed metadata:

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

Example response:

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

When no results are found, you receive:

{
  "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. Common Search Issues and Solutions

Empty results: Run the connectivity test, verify query spelling, try broader terms.
Connection errors: Check firewall or proxy settings, ensure *.wikipedia.org is reachable.
API limits: Requests with limit > 500 are automatically capped; negative values reset to the default (10).

4. Debugging with Verbose Logging

Launch the server with debug logging for deeper insight:

wikipedia-mcp --log-level DEBUG

This emits the request parameters, response status codes, and any warnings returned by the API.

Understanding the Model Context Protocol (MCP)

The Model Context Protocol (MCP) is not a traditional HTTP API but a specialized protocol for communication between LLMs and external tools. Key characteristics:

Uses stdio (standard input/output) or SSE (Server-Sent Events) for communication
Designed specifically for AI model interaction
Provides standardized formats for tools, resources, and prompts
Integrates directly with Claude and other MCP-compatible AI systems

Claude Desktop acts as the MCP client, while this server provides the tools and resources that Claude can use to access Wikipedia information.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Connect with the Author

🌐 Portfolio: ravikumar-dev.me
📝 Blog: Medium
💼 LinkedIn: in/ravi-kumar-e
🐦 Twitter: @Ravikumar_d3v

Wikipedia MCP Server

Overview

Verified By

Features

Search Wikipedia: Find articles matching specific queries with enhanced diagnostics
Retrieve Article Content: Get full article text with all information
Article Summaries: Get concise summaries of articles
Section Extraction: Retrieve specific sections from articles
Link Discovery: Find links within articles to related topics
Related Topics: Discover topics related to a specific article
Multi-language Support: Access Wikipedia in different languages by specifying the --language or -l argument when running the server (e.g., wikipedia-mcp --language ta for Tamil).
Country/Locale Support: Use intuitive country codes like --country US, --country China, or --country TW instead of language codes. Automatically maps to appropriate Wikipedia language variants.
Language Variant Support: Support for language variants such as Chinese traditional/simplified (e.g., zh-hans for Simplified Chinese, zh-tw for Traditional Chinese), Serbian scripts (sr-latn, sr-cyrl), and other regional variants.
Optional caching: Cache API responses for improved performance using --enable-cache
Google ADK Compatibility: Fully compatible with Google ADK agents and other AI frameworks that use strict function calling schemas

Installation

Using pipx (Recommended for Claude Desktop)

The best way to install for Claude Desktop usage is with pipx, which installs the command globally:

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

# Install the Wikipedia MCP server
pipx install wikipedia-mcp

This ensures the wikipedia-mcp command is available in Claude Desktop's PATH.

Installing via Smithery

To install wikipedia-mcp for Claude Desktop automatically via Smithery:

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

From PyPI (Alternative)

You can also install directly from PyPI:

pip install wikipedia-mcp

Using a virtual environment

# 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

From source

# 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 .

Usage

Running the server

# 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 sse    # For HTTP streaming

# 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 for SSE (use 0.0.0.0 for containers)
wikipedia-mcp --transport sse --host 0.0.0.0 --port 8080

# 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

# Security note for SSE: The transport does not define built-in endpoint authentication.
# To restrict access, run the server behind an authenticating reverse proxy (e.g., Nginx/Traefik),
# or expose it only on a private network/VPN and use firewall rules.

# Combine options
wikipedia-mcp --country Taiwan --enable-cache --access-token your_token --transport sse --port 8080

### Docker/Kubernetes

When running inside containers, bind the SSE 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 sse --host 0.0.0.0 --port 8080

Kubernetes example (minimal):

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", "sse", "--host", "0.0.0.0", "--port", "8080"]
          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"
    }
  }
}

Option 2: Using full path (recommended if you get connection errors)

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

Option 3: With country/language specification

{
  "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"]
    }
  }
}

To find the full path, run: which wikipedia-mcp

Configuration file locations:

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

Note: If you encounter connection errors, see the Troubleshooting section for solutions.

Documentation Index

CLI usage and options: see docs/CLI.md
API and MCP tools/resources: see docs/API.md
Architecture overview: see docs/ARCHITECTURE.md
User guide and troubleshooting: see docs/USER_GUIDE.md
Development guide: see docs/DEVELOPMENT.md
Testing guide: see docs/TESTING.md

Available MCP Tools

The Wikipedia MCP server provides the following tools for LLMs to interact with Wikipedia:

`search_wikipedia`

Search Wikipedia for articles matching a query.

Parameters:

query (string): The search term
limit (integer, optional): Maximum number of results to return (default: 10)

Returns:

A list of search results with titles, snippets, and metadata

`get_article`

Get the full content of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

Article content including text, summary, sections, links, and categories

`get_summary`

Get a concise summary of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A text summary of the article

`get_sections`

Get the sections of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A structured list of article sections with their content

`get_links`

Get the links contained within a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A list of links to other Wikipedia articles

`get_coordinates`

Get the coordinates of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article

Returns:

A dictionary containing coordinate information including:
- title: The article title
- pageid: The page ID
- coordinates: List of coordinate objects with latitude, longitude, and metadata
- exists: Whether the article exists
- error: Any error message if retrieval failed

`get_related_topics`

Get topics related to a Wikipedia article based on links and categories.

Parameters:

title (string): The title of the Wikipedia article
limit (integer, optional): Maximum number of related topics (default: 10)

Returns:

A list of related topics with relevance information

`summarize_article_for_query`

Get a summary of a Wikipedia article tailored to a specific query.

Parameters:

title (string): The title of the Wikipedia article
query (string): The query to focus the summary on
max_length (integer, optional): Maximum length of the summary (default: 250)

Returns:

A dictionary containing the title, query, and the focused summary

`summarize_article_section`

Get a summary of a specific section of a Wikipedia article.

Parameters:

title (string): The title of the Wikipedia article
section_title (string): The title of the section to summarize
max_length (integer, optional): Maximum length of the summary (default: 150)

Returns:

A dictionary containing the title, section title, and the section summary

`extract_key_facts`

Extract key facts from a Wikipedia article, optionally focused on a specific topic within the article.

Parameters:

title (string): The title of the Wikipedia article
topic_within_article (string, optional): A specific topic within the article to focus fact extraction
count (integer, optional): Number of key facts to extract (default: 5)

Returns:

A dictionary containing the title, topic, and a list of extracted facts

Country/Locale Support

Supported Countries and Regions

Use --list-countries to see all supported countries:

wikipedia-mcp --list-countries

This will display countries organized by language, for example:

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, ...

Usage Examples

# 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

Country-to-Language Mapping

The server automatically maps country codes to appropriate Wikipedia language editions:

English-speaking: US, UK, Canada, Australia, New Zealand, Ireland, South Africa → en
Chinese regions:
- CN, China → zh-hans (Simplified Chinese)
- TW, Taiwan → zh-tw (Traditional Chinese - Taiwan)
- HK, Hong Kong → zh-hk (Traditional Chinese - Hong Kong)
- SG, Singapore → zh-sg (Simplified Chinese - Singapore)
Major languages: JP→ja, DE→de, FR→fr, ES→es, IT→it, RU→ru, etc.
Regional variants: Supports 140+ countries and regions

Error Handling

If you specify an unsupported country, you'll get a helpful error message:

$ 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.

Language Variants

Supported Language Variants

Chinese Language Variants

zh-hans - Simplified Chinese
zh-hant - Traditional Chinese
zh-tw - Traditional Chinese (Taiwan)
zh-hk - Traditional Chinese (Hong Kong)
zh-mo - Traditional Chinese (Macau)
zh-cn - Simplified Chinese (China)
zh-sg - Simplified Chinese (Singapore)
zh-my - Simplified Chinese (Malaysia)

Serbian Language Variants

sr-latn - Serbian Latin script
sr-cyrl - Serbian Cyrillic script

Kurdish Language Variants

ku-latn - Kurdish Latin script
ku-arab - Kurdish Arabic script

Norwegian Language Variants

no - Norwegian (automatically mapped to Bokmål)

Usage Examples

# 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

How Language Variants Work

When you specify a language variant like zh-hans, the server:

Maps the variant to the base Wikipedia language (e.g., zh for Chinese variants)
Uses the base language for API connections to the Wikipedia servers
Includes the variant parameter in API requests to get content in the specific variant
Returns content formatted according to the specified variant's conventions

This approach ensures optimal compatibility with Wikipedia's API while providing access to variant-specific content and formatting.

Example Prompts

Once the server is running and configured with Claude Desktop, you can use prompts like:

General Wikipedia queries:

"Tell me about quantum computing using the Wikipedia information."
"Summarize the history of artificial intelligence based on Wikipedia."
"What does Wikipedia say about climate change?"
"Find Wikipedia articles related to machine learning."
"Get me the introduction section of the article on neural networks from Wikipedia."
"What are the coordinates of the Eiffel Tower?"
"Find the latitude and longitude of Mount Everest from Wikipedia."
"Get coordinate information for famous landmarks in Paris."

Using country-specific Wikipedia:

"Search Wikipedia China for information about the Great Wall." (uses Chinese Wikipedia)
"Tell me about Tokyo from Japanese Wikipedia sources."
"What does German Wikipedia say about the Berlin Wall?"
"Find information about the Eiffel Tower from French Wikipedia."
"Get Taiwan Wikipedia's article about Taiwanese cuisine."

Language variant examples:

"Search Traditional Chinese Wikipedia for information about Taiwan."
"Find Simplified Chinese articles about modern China."
"Get information from Serbian Latin Wikipedia about Belgrade."

MCP Resources

The server also provides MCP resources (similar to HTTP endpoints but for MCP):

search/{query}: Search Wikipedia for articles matching the query
article/{title}: Get the full content of a Wikipedia article
summary/{title}: Get a summary of a Wikipedia article
sections/{title}: Get the sections of a Wikipedia article
links/{title}: Get the links in a Wikipedia article
coordinates/{title}: Get the coordinates of a Wikipedia article
summary/{title}/query/{query}/length/{max_length}: Get a query-focused summary of an article
summary/{title}/section/{section_title}/length/{max_length}: Get a summary of a specific article section
facts/{title}/topic/{topic_within_article}/count/{count}: Extract key facts from an article

Development

Local Development Setup

# 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

Project Structure

wikipedia_mcp/: Main package
- __main__.py: Entry point for the package
- server.py: MCP server implementation
- wikipedia_client.py: Wikipedia API client
- api/: API implementation
- core/: Core functionality
- utils/: Utility functions
tests/: Test suite
- test_basic.py: Basic package tests
- test_cli.py: Command-line interface tests
- test_server_tools.py: Comprehensive server and tool tests

Testing

The project includes a comprehensive test suite to ensure reliability and functionality.

Test Structure

The test suite is organized in the tests/ directory with the following test files:

test_basic.py: Basic package functionality tests
test_cli.py: Command-line interface and transport tests
test_server_tools.py: Comprehensive tests for all MCP tools and Wikipedia client functionality

Running Tests

Run All Tests

# 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 Specific Test Categories

# 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

Test Categories

Unit Tests

WikipediaClient Tests: Mock-based tests for all client methods
- Search functionality
- Article retrieval
- Summary extraction
- Section parsing
- Link extraction
- Related topics discovery
Server Tests: MCP server creation and tool registration
CLI Tests: Command-line interface functionality

Integration Tests

Real API Tests: Tests that make actual calls to Wikipedia API
End-to-End Tests: Complete workflow testing

Test Configuration

The project uses pytest.ini for test configuration:

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

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

Continuous Integration

All tests are designed to:

Run reliably in CI/CD environments
Handle network failures gracefully
Provide clear error messages
Cover edge cases and error conditions

Adding New Tests

When contributing new features:

Add unit tests for new functionality
Include both success and failure scenarios
Mock external dependencies (Wikipedia API)
Add integration tests for end-to-end validation
Follow existing test patterns and naming conventions

Troubleshooting

Common Issues

Claude Desktop Connection Issues

Problem: Claude Desktop shows errors like spawn wikipedia-mcp ENOENT or cannot find the command.

Cause: This occurs when the wikipedia-mcp command is installed in a user-specific location (like ~/.local/bin/) that's not in Claude Desktop's PATH.

Solutions:

Use full path to the command (Recommended):

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

To find your exact path, run: which wikipedia-mcp

Install with pipx for global access:

pipx install wikipedia-mcp

Then use the standard configuration:

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

Create a symlink to a global location:

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

Other Issues

Article Not Found: Check the exact spelling of article titles
Rate Limiting: Wikipedia API has rate limits; consider adding delays between requests
Large Articles: Some Wikipedia articles are very large and may exceed token limits

Troubleshooting Search Issues

If you're experiencing empty search results, use the new diagnostic tools:

1. Test Connectivity

Use the test_wikipedia_connectivity tool to check if you can reach Wikipedia's API:

{
  "tool": "test_wikipedia_connectivity"
}

This returns diagnostics including:

Connection status (success or failed)
Response time in milliseconds
Site/host information when successful
Error details when connectivity fails

2. Enhanced Search Error Information

The search_wikipedia tool now returns detailed metadata:

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

Example response:

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

When no results are found, you receive:

{
  "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. Common Search Issues and Solutions

Empty results: Run the connectivity test, verify query spelling, try broader terms.
Connection errors: Check firewall or proxy settings, ensure *.wikipedia.org is reachable.
API limits: Requests with limit > 500 are automatically capped; negative values reset to the default (10).

4. Debugging with Verbose Logging

Launch the server with debug logging for deeper insight:

wikipedia-mcp --log-level DEBUG

This emits the request parameters, response status codes, and any warnings returned by the API.

Understanding the Model Context Protocol (MCP)

The Model Context Protocol (MCP) is not a traditional HTTP API but a specialized protocol for communication between LLMs and external tools. Key characteristics:

Uses stdio (standard input/output) or SSE (Server-Sent Events) for communication
Designed specifically for AI model interaction
Provides standardized formats for tools, resources, and prompts
Integrates directly with Claude and other MCP-compatible AI systems

Claude Desktop acts as the MCP client, while this server provides the tools and resources that Claude can use to access Wikipedia information.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Connect with the Author

🌐 Portfolio: ravikumar-dev.me
📝 Blog: Medium
💼 LinkedIn: in/ravi-kumar-e
🐦 Twitter: @Ravikumar_d3v