wiki-mcp

MCP (Model Context Protocol) server for Wikipedia. Provides tools to search articles, retrieve content, summaries, categories, links, images, language versions, and external references.

Features

• 9 Wikipedia tools for comprehensive article access
• Proper TypeScript types for all API responses
• Request timeout handling
• Error handling with informative messages
• Modular architecture

Tools

Installation

Quick install (recommended)

bunx wiki-mcp install

This automatically adds wiki-mcp to Claude Desktop and Claude Code.

Manual install

# Or install globally
bun add -g wiki-mcp
npm install -g wiki-mcp

Via Smithery

npx @smithery/cli install wiki-mcp

From source

git clone https://github.com/msilverblatt/wiki-mcp.git
cd wiki-mcp
bun install

Usage

With Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "wikipedia": {
      "command": "bunx",
      "args": ["wiki-mcp"]
    }
  }
}

With Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "wikipedia": {
      "command": "bunx",
      "args": ["wiki-mcp"]
    }
  }
}

Standalone

bun run index.ts

The server communicates via stdio using the MCP protocol.

Tool Examples

wiki_search

Search for articles:

{
  "query": "artificial intelligence",
  "limit": 5
}

Returns:

[
  {
    "title": "Artificial intelligence",
    "snippet": "Artificial intelligence (AI) is the intelligence of machines...",
    "pageid": 1234
  }
]

wiki_get_article

Get full article content:

{
  "title": "JavaScript"
}

Returns plain text article content.

wiki_get_summary

Get article summary:

{
  "title": "TypeScript"
}

Returns:

{
  "title": "TypeScript",
  "description": "Programming language",
  "extract": "TypeScript is a strongly typed programming language...",
  "url": "https://en.wikipedia.org/wiki/TypeScript"
}

wiki_get_categories

Get article categories:

{
  "title": "Python (programming language)",
  "limit": 10
}

Returns:

{
  "title": "Python (programming language)",
  "categories": ["Programming languages", "Scripting languages", "..."]
}

wiki_get_links

Get internal links:

{
  "title": "Machine learning",
  "limit": 50
}

Returns:

{
  "title": "Machine learning",
  "links": ["Artificial intelligence", "Data science", "..."]
}

wiki_get_images

Get article images:

{
  "title": "Solar System",
  "limit": 20
}

Returns:

{
  "title": "Solar System",
  "images": [
    {
      "title": "Solar System.jpg",
      "url": "https://en.wikipedia.org/wiki/File:Solar_System.jpg"
    }
  ]
}

wiki_get_languages

Get available translations:

{
  "title": "Albert Einstein"
}

Returns:

{
  "title": "Albert Einstein",
  "languageCount": 200,
  "languages": [
    {
      "language": "Deutsch",
      "code": "de",
      "title": "Albert Einstein",
      "url": "https://de.wikipedia.org/wiki/Albert_Einstein"
    }
  ]
}

wiki_get_references

Get external references:

{
  "title": "Climate change",
  "limit": 30
}

Returns:

{
  "title": "Climate change",
  "references": ["https://www.ipcc.ch/", "..."]
}

wiki_random

Get random articles:

{
  "count": 3
}

Returns:

[
  { "title": "Random Article 1", "id": 12345 },
  { "title": "Random Article 2", "id": 67890 }
]

Development

# Run tests
bun test

# Type check
bun run typecheck

# Start server
bun run start

Project Structure

wiki-mcp/
├── index.ts              # Entry point
├── src/
│   ├── api.ts            # Wikipedia API client
│   ├── server.ts         # MCP server setup
│   ├── types.ts          # TypeScript interfaces
│   └── tools/
│       ├── index.ts      # Tool registration
│       ├── search.ts     # wiki_search
│       ├── article.ts    # wiki_get_article
│       ├── summary.ts    # wiki_get_summary
│       ├── random.ts     # wiki_random
│       ├── categories.ts # wiki_get_categories
│       ├── links.ts      # wiki_get_links
│       ├── images.ts     # wiki_get_images
│       ├── languages.ts  # wiki_get_languages
│       └── references.ts # wiki_get_references
└── tests/
    ├── api.test.ts       # API helper tests
    └── tools.test.ts     # Tool integration tests

License

MIT