MCP Wikipedia Server

A production-ready Model Context Protocol (MCP) server that provides Wikipedia search and content retrieval tools using FastMCP and Python 3.11.

Python 3.11 MCP License

🚀 Quick Start

# 1. Set up environment (one-time setup)
./setup.sh

# 2. Start the server
source .venv311/bin/activate
cd src/mcp_server && python mcp_server.py

# 3. Test with example client
python example_client.py

🎯 Features

Wikipedia Search: Find articles with intelligent search and get comprehensive summaries
Section Listing: Extract all section titles from any Wikipedia article
Content Retrieval: Get specific section content with proper formatting
MCP Protocol: Full Model Context Protocol compatibility for AI assistant integration
FastMCP Framework: Built on the efficient FastMCP library for optimal performance
Python 3.11: Modern Python with latest features and performance improvements

📚 Documentation

Document	Description
📖 Complete Guide	Detailed setup, usage, and development instructions
⚡ Quick Reference	Common commands and tool summaries
🔧 Setup Script	Automated environment setup and verification
💡 Example Client	Sample usage and integration examples

🛠️ Available Tools

Tool	Purpose	Example Usage
`fetch_wikipedia_info`	Search Wikipedia and get article summaries	Search for "Python programming"
`list_wikipedia_sections`	Get all section titles from an article	List sections of "Machine Learning"
`get_section_content`	Retrieve specific section content	Get "History" section from "Artificial Intelligence"

🏗️ Project Structure

MCPClientServer/
├── 📁 src/mcp_server/           # Core server implementation
│   ├── mcp_server.py           # Main MCP Wikipedia server
│   └── mcp_client.py           # Example MCP client
├── 📁 tests/                   # Comprehensive test suite
│   ├── test_server.py          # Unit tests (pytest)
│   ├── test_integration.py     # Integration tests
│   ├── test_performance.py     # Performance benchmarks
│   ├── test_mcp_compliance.py  # MCP protocol compliance
│   ├── quick_test.py           # Fast validation script
│   ├── run_tests.py            # Unified test runner
│   └── README.md               # Testing documentation
├── 📁 .venv311/               # Python 3.11 virtual environment
├── 🔧 setup.sh                # Automated setup script
├── 💡 example_client.py        # Usage examples and demos
├── 📖 GUIDE.md                # Complete documentation
├── ⚡ QUICK_REF.md             # Quick reference
├── 📄 pytest.ini              # Test configuration
├── 📄 requirements-test.txt    # Test dependencies
└── 📄 pyproject.toml          # Project configuration

🚦 Prerequisites

macOS (tested on Apple Silicon and Intel)
Python 3.11+ (installed via pyenv recommended)
Git (for version control)

📦 Installation Options

Option 1: Automated Setup (Recommended)

chmod +x setup.sh
./setup.sh

Option 2: Manual Setup

# Set up Python 3.11 environment
pyenv install 3.11.10
pyenv local 3.11.10

# Create and activate virtual environment
python -m venv .venv311
source .venv311/bin/activate

# Install dependencies
pip install --upgrade pip
pip install wikipedia mcp fastmcp

🔌 Integration Examples

With Claude Desktop (MCP Client)

{
  "mcpServers": {
    "wikipedia": {
      "command": "python",
      "args": ["/path/to/MCPClientServer/src/mcp_server/mcp_server.py"],
      "env": {
        "PYTHONPATH": "/path/to/MCPClientServer/.venv311/lib/python3.11/site-packages"
      }
    }
  }
}

Direct Python Usage

from mcp_client import WikipediaClient

client = WikipediaClient()
result = await client.search_wikipedia("Artificial Intelligence")
print(result)

🧪 Testing

Quick Testing

# Fast validation (10 seconds)
python tests/quick_test.py

# Comprehensive test suite (5 minutes)
python tests/run_tests.py

Advanced Testing

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

# Run specific test suites
python tests/run_tests.py --unit          # Unit tests only
python tests/run_tests.py --integration   # Integration tests only
python tests/run_tests.py --performance   # Performance benchmarks
python tests/run_tests.py --mcp          # MCP compliance tests

# Using pytest directly
python -m pytest tests/test_server.py -v --cov=src

Test Suite Overview

Unit Tests: Individual function and component testing
Integration Tests: End-to-end workflow validation
Performance Tests: Response time and load benchmarks
MCP Compliance: Protocol specification validation
95%+ Code Coverage: Comprehensive test coverage

See tests/README.md for complete testing documentation.

🐛 Troubleshooting

Issue	Solution
`ModuleNotFoundError: No module named 'mcp'`	Run `pip install mcp fastmcp` in activated environment
`Python version issues`	Ensure Python 3.11+ with `python --version`
`Server won't start`	Check if port is available, verify dependencies
`Wikipedia API errors`	Check internet connection, try different search terms

For detailed troubleshooting, see GUIDE.md.

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

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

🔗 Resources

🌟 Support

If you find this project helpful, please consider giving it a star ⭐ on GitHub!

Made with ❤️ for the MCP community

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A production-ready server that provides Wikipedia search and content retrieval tools through the Model Context Protocol, enabling AI assistants to search for articles, list sections, and retrieve specific content.

Related MCP Servers

Wikipedia MCP Server
Rudra-ravi
A
security
A
license
A
quality
A Model Context Protocol server that retrieves information from Wikipedia to provide context to LLMs, allowing users to search articles, get summaries, full content, sections, and links from Wikipedia.
Last updated -
10
106
MIT License
Wikidata MCP Server
zzaebok
A
security
A
license
A
quality
A server implementation for interacting with Wikidata API using the Model Context Protocol, providing tools for searching identifiers, extracting metadata, and executing SPARQL queries.
Last updated -
5
25
MIT License
Wikipedia MCP Server
danbunnell
-
security
F
license
-
quality
An MCP server that retrieves and provides Wikipedia content for requested topics, enabling easy access to Wikipedia information directly through the Model Control Protocol.
Last updated -
1
MCP-IQWiki
IQAIcom
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants and applications to access IQ.wiki data, enabling retrieval of specific wikis, user-created wikis, user-edited wikis, and detailed wiki activities.
Last updated -
5
24
1
MIT License

View all related MCP servers

MCP Wikipedia Server

MCP Wikipedia Server

🚀 Quick Start

🎯 Features

📚 Documentation

🛠️ Available Tools

🏗️ Project Structure

🚦 Prerequisites

📦 Installation Options

Option 1: Automated Setup (Recommended)

Option 2: Manual Setup

🔌 Integration Examples

With Claude Desktop (MCP Client)

Direct Python Usage

🧪 Testing

Quick Testing

Advanced Testing

Test Suite Overview

🐛 Troubleshooting

🤝 Contributing

📄 License

🔗 Resources

🌟 Support

Related MCP Servers

Wikipedia MCP Server

Wikidata MCP Server

Wikipedia MCP Server

MCP-IQWiki

New MCP Servers

MCP directory API