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

Related MCP server: Wikidata MCP Server

🎯 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

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

Resources

New MCP Servers

Latest Blog Posts

MCP directory API