# wiki-mcp

[![npm version](https://img.shields.io/npm/v/wiki-mcp.svg)](https://www.npmjs.com/package/wiki-mcp)
[![Smithery](https://smithery.ai/badge/wiki-mcp)](https://smithery.ai/server/wiki-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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

| Tool | Description |
|------|-------------|
| `wiki_search` | Search Wikipedia for articles matching a query |
| `wiki_get_article` | Get the full text content of an article |
| `wiki_get_summary` | Get a short summary of an article |
| `wiki_random` | Get random Wikipedia articles |
| `wiki_get_categories` | Get categories an article belongs to |
| `wiki_get_links` | Get internal Wikipedia links from an article |
| `wiki_get_images` | Get images used in an article |
| `wiki_get_languages` | Get available language versions of an article |
| `wiki_get_references` | Get external references/links from an article |

## Installation

### Quick install (recommended)

```bash
bunx wiki-mcp install
```

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

### Manual install

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

### Via Smithery

```bash
npx @smithery/cli install wiki-mcp
```

### From source

```bash
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):

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

### With Claude Code

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

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

### Standalone

```bash
bun run index.ts
```

The server communicates via stdio using the MCP protocol.

## Tool Examples

### wiki_search

Search for articles:

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

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

### wiki_get_article

Get full article content:

```json
{
  "title": "JavaScript"
}
```

Returns plain text article content.

### wiki_get_summary

Get article summary:

```json
{
  "title": "TypeScript"
}
```

Returns:
```json
{
  "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:

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

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

### wiki_get_links

Get internal links:

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

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

### wiki_get_images

Get article images:

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

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

### wiki_get_languages

Get available translations:

```json
{
  "title": "Albert Einstein"
}
```

Returns:
```json
{
  "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:

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

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

### wiki_random

Get random articles:

```json
{
  "count": 3
}
```

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

## Development

```bash
# 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