Wikipedia MCP Server for Vercel

A Model Context Protocol (MCP) server that provides Wikipedia information access through Vercel's serverless functions.

Features

This MCP server provides the following tools:

• search_wikipedia - Search Wikipedia for articles matching a query
• get_article - Get the full content of a Wikipedia article
• get_summary - Get a concise summary of a Wikipedia article
• get_sections - Get the sections of a Wikipedia article
• get_coordinates - Get the geographic coordinates of a Wikipedia article
• get_related_topics - Get topics related to a Wikipedia article

All tools support multi-language Wikipedia by specifying a language code (e.g., 'en', 'es', 'fr', 'ja', 'zh').

Prerequisites

• Node.js 18.x or later
• npm or yarn
• A Vercel account (free tier works fine)

Local Development

1. Install dependencies:

   npm install
   

2. Run the development server:

   npm run dev
   

3. Test the MCP server:

   The MCP endpoint will be available at http://localhost:3000/api/mcp

4. Test with MCP Inspector:

   npx @modelcontextprotocol/inspector@latest http://localhost:3000
   

   Then:

   • Open http://127.0.0.1:6274 in your browser
   • Select "Streamable HTTP" from the dropdown
   • Enter http://localhost:3000/api/mcp as the URL
   • Click "Connect"
   • Test the tools under the "Tools" section

Deployment to Vercel

Option 1: Deploy via Vercel CLI

1. Install Vercel CLI (if not already installed):

   npm i -g vercel
   

2. Deploy to Vercel:

   vercel
   

3. Follow the prompts:

   • Link to an existing project or create a new one
   • Confirm the settings
   • Deploy!

4. Deploy to production:

   vercel --prod
   

Option 2: Deploy via GitHub

1. Push your code to GitHub:

   git init
   git add .
   git commit -m "Initial commit"
   git branch -M main
   git remote add origin <your-github-repo-url>
   git push -u origin main
   

2. Connect to Vercel:

   • Go to vercel.com
   • Click "Add New Project"
   • Import your GitHub repository
   • Vercel will auto-detect Next.js and configure everything
   • Click "Deploy"

Option 3: Deploy via Vercel Dashboard

1. Create a new project in Vercel:

   • Go to vercel.com/new
   • Import your Git repository or upload your project

2. Configure the project:

   • Framework Preset: Next.js
   • Root Directory: ./
   • Build Command: next build
   • Output Directory: .next

3. Deploy!

Using Your Deployed MCP Server

After deployment, you'll get a URL like https://your-project.vercel.app

Configure in Claude Desktop (or other MCP clients)

Add this to your Claude Desktop configuration file:

Location of config file:

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

Configuration:

{
  "mcpServers": {
    "wikipedia": {
      "url": "https://your-project.vercel.app/api/mcp"
    }
  }
}

Configure in Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "wikipedia": {
      "url": "https://your-project.vercel.app/api/mcp"
    }
  }
}

Configure in Windsurf

Add to mcp_config.json:

{
  "mcpServers": {
    "wikipedia": {
      "serverUrl": "https://your-project.vercel.app/api/mcp"
    }
  }
}

Example Queries

Once connected, you can ask your AI assistant:

• "Search Wikipedia for information about quantum computing"
• "Get me a summary of the article about Claude Shannon"
• "What are the geographic coordinates of Mount Everest?"
• "Find related topics to artificial intelligence on Wikipedia"
• "Search Japanese Wikipedia for information about Tokyo" (the server will handle the language parameter)

API Endpoints

• GET/POST/DELETE /api/mcp - Main MCP endpoint
• GET / - Info page about available tools

Tool Parameters

search_wikipedia

• query (string, required): The search term
• limit (number, optional): Maximum results (1-50, default: 10)
• language (string, optional): Wikipedia language code (default: 'en')

get_article

• title (string, required): Article title
• language (string, optional): Wikipedia language code (default: 'en')

get_summary

• title (string, required): Article title
• language (string, optional): Wikipedia language code (default: 'en')

get_sections

• title (string, required): Article title
• language (string, optional): Wikipedia language code (default: 'en')

get_coordinates

• title (string, required): Article title
• language (string, optional): Wikipedia language code (default: 'en')

get_related_topics

• title (string, required): Article title
• limit (number, optional): Maximum results (1-50, default: 10)
• language (string, optional): Wikipedia language code (default: 'en')

Architecture

This MCP server is built using:

• Next.js 15 - React framework for production
• mcp-handler - Official MCP handler package for Vercel
• Wikipedia API - MediaWiki Action API for Wikipedia data
• Vercel Functions - Serverless functions with Fluid Compute

Performance & Scaling

The server leverages Vercel's Fluid Compute features:

• Optimized Concurrency - Efficient request handling
• Dynamic Scaling - Scales based on demand
• Minimal Idle Time - Pay only for what you use

Troubleshooting

MCP client can't connect

• Verify your MCP endpoint URL is correct: https://your-project.vercel.app/api/mcp
• Check that the deployment is successful in Vercel dashboard
• Try accessing the root URL to see if the server is running

Tools not showing up

• Restart your MCP client (Claude Desktop, Cursor, etc.)
• Check the MCP client logs for connection errors
• Verify the configuration file syntax is correct

Wikipedia API errors

• Most errors are due to incorrect article titles (they're case-sensitive)
• Some articles may not exist in the specified language
• Rate limiting may occur with excessive requests

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT License - feel free to use this in your own projects!

Credits

Based on the wikipedia-mcp Python implementation by Rudra-ravi, adapted for Vercel deployment using TypeScript and the mcp-handler package.

Resources

• Vercel MCP Documentation
• Model Context Protocol Specification
• Wikipedia API Documentation