What is Wikipedia Mcp Server

The wikipedia-mcp-server is an MCP (Model Context Protocol) server designed for interacting with the Wikipedia API, allowing AI assistants to access and retrieve Wikipedia content.

Use cases

Use cases include developing AI assistants that provide historical information, creating educational tools that require Wikipedia content, and building applications that need to display images or articles from Wikipedia.

How to use

To use the wikipedia-mcp-server, install it via npm with ‘npm install @shelm/wikipedia-mcp-server’. You can run the server using ‘npx @shelm/wikipedia-mcp-server’ or integrate it programmatically in your projects by creating an instance of WikipediaServer and calling its methods.

Key features

Key features include tools for retrieving historical events on specific dates (onThisDay), searching for Wikipedia pages (findPage), getting the content of a page by title (getPage), and retrieving images from a page (getImagesForPage).

Where to use

The wikipedia-mcp-server can be used in various fields such as education, research, and AI development, particularly where access to Wikipedia data is beneficial.

Wikipedia MCP Server

An MCP (Model Context Protocol) server for Wikipedia API interactions.

Overview

This server provides tools for interacting with the Wikipedia API through the Model Context Protocol. It allows AI assistants to access Wikipedia content, search for articles, get historical events, and retrieve images.

Features

The server provides the following tools:

• onThisDay: Get historical events that occurred on a specific date
• findPage: Search for Wikipedia pages matching a query
• getPage: Get content of a Wikipedia page by title
• getImagesForPage: Get images from a Wikipedia page by title

Installation

npm install @shelm/wikipedia-mcp-server

For development:

git clone https://github.com/scotthelm/wikipedia-mcp-server.git
cd wikipedia-mcp-server
npm install
npm run build

Usage

Running the Server

npx @shelm/wikipedia-mcp-server

This will start the MCP server, which communicates over stdio.

Using Programmatically

You can also use the package programmatically in your own projects:

import {
  WikipediaServer,
  isValidOnThisDayArgs,
  isValidFindPageArgs,
  isValidGetPageArgs,
  isValidGetImagesForPageArgs,
} from "@shelm/wikipedia-mcp-server";

// Create a new server instance
const server = new WikipediaServer();

// Run the server
server.run().catch(console.error);

// Or use the validation functions and handlers directly
if (isValidOnThisDayArgs({ date: "2023-01-01" })) {
  const result = await server.handleOnThisDay({ date: "2023-01-01" });
  console.log(result);
}

Example Client

An example client is provided to demonstrate how to interact with the server:

node example-client.js

This will:

1. Start the server
2. Query for available tools
3. Demonstrate each tool with sample queries
4. Display the results in a simple web interface at http://localhost:3000

Development

Building

npm run build

Running in Development Mode

npm run dev

Testing

This project can be tested manually using the example client:

node example-client.js

This will demonstrate all the available tools with sample queries.

MCP Server Configuration

To use this server with Claude or other MCP-compatible assistants, add it to your MCP configuration:

{
  "mcpServers": {
    "wikipedia": {
      "command": "npx",
      "args": [
        "@shelm/wikipedia-mcp-server"
      ],
      "env": {}
    }
  }
}

Attribution

This would not be possible without the great work done by the folks who created the wikipedia package

License

MIT