Wikipedia MCP Server (ASP.NET Core 8)

A production-ready Model Context Protocol (MCP) server implementation for Wikipedia search and content retrieval, built with ASP.NET Core 8 and C#. Features comprehensive testing with 206 total tests and enterprise-grade reliability.

Features

This server provides three main Wikipedia-related tools with full test coverage:

1. Wikipedia Search - Search for Wikipedia articles and get summaries
2. Wikipedia Sections - Get the section outline of a Wikipedia page
3. Wikipedia Section Content - Retrieve content from specific sections of Wikipedia articles

🏆 Production Ready

• ✅ 150 comprehensive tests (Unit, Service, Integration, stdio)
• ✅ 100% test pass rate ensuring reliability
• ✅ Automated stdio mode testing with real process spawning
• ✅ Professional .NET project structure with src/ and tests/ organization
• ✅ Enhanced error handling and validation
• ✅ Code coverage reporting with detailed analysis
• ✅ Dual-mode operation (HTTP API + MCP Protocol)
• ✅ Enterprise-grade logging and monitoring

Quick Start

Prerequisites

• .NET 8.0 SDK
• Visual Studio Code with GitHub Copilot extension (for MCP mode)

Installation

1. Clone the repository:

   git clone <repository-url>
   cd WikipediaMcpServer
   

2. Restore dependencies:

   dotnet restore
   

3. Build the project:

   cd src/WikipediaMcpServer
   dotnet build
   

Usage Modes

This server supports three MCP-compliant transport modes with 96%+ MCP specification compliance:

🏆 Transport Mode Summary

All transport modes provide the same Wikipedia tools with consistent, professional-grade MCP specification compliance.

1. stdio Mode - For Local AI Client Integration (Recommended) ✅ 96% MCP Compliant

Run in stdio (standard input/output) mode for seamless integration with AI clients like VS Code and Claude Desktop:

dotnet run --project src/WikipediaMcpServer/WikipediaMcpServer.csproj -- --mcp

MCP Compliance Features:

• 🔄 Protocol Version Negotiation - Supports both 2024-11-05 and 2025-06-18
• 📬 Notification Support - Proper notifications/initialized handling
• 🎯 Enhanced Capabilities - Dynamic capabilities based on protocol version
• 👤 Client Information - Extracts and logs client details
• ✅ JSON-RPC 2.0 - Full specification compliance

Benefits:

• 🔐 Secure - No network ports exposed
• 🚀 Fast - Direct process communication
• 🎯 Simple - No HTTP/SSE overhead
• ✅ Compatible - Works with VS Code MCP Extension, Claude Desktop, and other MCP clients

VS Code Configuration (mcp.json):

{
  "mcpServers": {
    "wikipedia-local": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/src/WikipediaMcpServer/WikipediaMcpServer.csproj",
        "--",
        "--mcp"
      ],
      "env": {
        "DOTNET_ENVIRONMENT": "Development"
      },
      "description": "Local Wikipedia MCP Server"
    }
  }
}

Claude Desktop Configuration:

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wikipedia": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/src/WikipediaMcpServer/WikipediaMcpServer.csproj",
        "--",
        "--mcp"
      ]
    }
  }
}

Testing stdio Mode:

# Test manually with a simple initiali

... [View full README on GitHub](https://github.com/ajayindfw/WikipediaMcpServer#readme)