Mediawiki MCP Adapter

🚀 MediaWiki Adapter

A custom Model Context Protocol (MCP) adapter for interacting with MediaWiki and WikiBase APIs. This adapter allows you to programmatically fetch and edit MediaWiki pages using the MCP framework.

🚀 Quick Start

This MediaWiki adapter enables seamless interaction with MediaWiki and WikiBase APIs through the MCP framework. Below are the steps to get started:

Prerequisites

• Node.js (v16 or higher)
• TypeScript (for development)
• A MediaWiki instance with API access enabled

Installation

1. Clone the repository:

git clone https://github.com/yourusername/mediawikiadapter.git
cd mediawikiadapter

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

You can configure the adapter to use custom MediaWiki and WikiBase API endpoints:

server.configure({
  mediaWikiAPIBase: "https://my.mediawiki.instance/api.php",
  wikiBaseAPIBase: "https://my.wikibase.instance/api.php",
});

Start the MCP Server

Run the MCP server using the following command:

node build/index.js

✨ Features

• Fetch the content of MediaWiki pages.
• Edit MediaWiki pages with new content (and an optional summary).
• Configurable API base URLs for different MediaWiki and WikiBase instances.

💻 Usage Examples

Basic Usage

getPageContent

Fetch the content of a MediaWiki page.

• Input Schema:

{
  "title": "string"
}

• Output Schema:

{
  "content": "string"
}

• Example Usage:

const response = await server.callResource("getPageContent", {
  title: "Main Page",
});
console.log(response.content);

Advanced Usage

editPage

Edit a MediaWiki page with new content.

• Input Schema:

{
  "title": "string",
  "content": "string",
  "summary": "string (optional)"
}

• Output Schema:

{
  "success": "boolean"
}

• Example Usage:

const response = await server.callTool("editPage", {
  title: "Main Page",
  content: "New content...",
  summary: "Update page content"
});
console.log(response.success);

🔧 Technical Details

Development

• Run in Development Mode:

npm run dev

• Check Code Quality:

npm run lint

• Run Tests:

npm test

Configuration

By default, the adapter uses the following API base URLs:

You can override these default values via the server.configure() method.

🤝 Contribution Guidelines

To contribute to the project, follow these steps:

1. Clone the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the remote repository.
5. Create a pull request.

Please ensure you read and follow the project's contribution guidelines and code style guide before submitting your code.

📄 License

The project is governed by the [license specified here](# license). Refer to the LICENSE file for detailed information.

👨‍💻 Author

• Lucas - Source

This document is generated by [the build tool or framework specified here](# framework).