# wiki-mcp
[](https://www.npmjs.com/package/wiki-mcp)
[](https://smithery.ai/server/wiki-mcp)
[](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
