wikipedia-mcp-server

# 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 ```bash npm install @shelm/wikipedia-mcp-server ``` For development: ```bash git clone https://github.com/scotthelm/wikipedia-mcp-server.git cd wikipedia-mcp-server npm install npm run build ``` ## Usage ### Running the Server ```bash 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: ```javascript 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: ```bash 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 ```bash npm run build ``` ### Running in Development Mode ```bash npm run dev ``` ### Testing This project can be tested manually using the example client: ```bash 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: ```json { "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](https://github.com/dopecodez/wikipedia) ## License MIT