Skip to main content
Glama

MCP Wikipedia Server

by kaman05010

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

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

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

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. πŸš€ Quick Start
    1. 🎯 Features
      1. πŸ“š Documentation
        1. πŸ› οΈ Available Tools
          1. πŸ—οΈ Project Structure
            1. 🚦 Prerequisites
              1. πŸ“¦ Installation Options
                1. Option 1: Automated Setup (Recommended)
                2. Option 2: Manual Setup
              2. πŸ”Œ Integration Examples
                1. With Claude Desktop (MCP Client)
                2. Direct Python Usage
              3. πŸ§ͺ Testing
                1. Quick Testing
                2. Advanced Testing
                3. Test Suite Overview
              4. πŸ› Troubleshooting
                1. 🀝 Contributing
                  1. πŸ“„ License
                    1. πŸ”— Resources
                      1. 🌟 Support

                        Related MCP Servers

                        • 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
                          122
                          MIT License
                          • Apple
                          • Linux
                        • 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
                          27
                          MIT License
                        • -
                          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
                          • Linux
                          • Apple
                        • 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
                          16
                          1
                          MIT License

                        View all related MCP servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/kaman05010/MCPClientServer'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server