What is Mediawiki Mcp Adapter

MediaWiki-MCP-adapter is a custom Model Context Protocol (MCP) adapter designed for interacting with MediaWiki and WikiBase APIs. It enables programmatic fetching and editing of MediaWiki pages within the MCP framework.

Use cases

Use cases include automated content updates on MediaWiki pages, integration of MediaWiki with other applications, and building tools for content analysis or management that leverage the MediaWiki API.

How to use

To use MediaWiki-MCP-adapter, first configure the adapter with your MediaWiki and WikiBase API endpoints. Then, start the MCP server and utilize the provided methods, such as ‘getPageContent’ to fetch page content and ‘editPage’ to edit pages.

Key features

Key features include the ability to fetch content from MediaWiki pages, edit pages with new content and optional summaries, and configurable API base URLs for different MediaWiki and WikiBase instances.

Where to use

MediaWiki-MCP-adapter can be used in various fields such as content management systems, educational platforms, and collaborative projects that require interaction with MediaWiki and WikiBase APIs.

MediaWikiAdapter

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

Features

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

Requirements

• Node.js (v16 or later)
• TypeScript (for development)
• 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
   

Usage

Configure the Adapter

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

Resources

getPageContent

Fetches 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);

Tools

editPage

Edits 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: "Updated content for the page.",
  summary: "Updated via MediaWikiAdapter",
});
console.log(response.success ? "Edit successful" : "Edit failed");

Development

Run in Development Mode

To run the project in development mode with TypeScript:

npm run dev

Linting

Run the linter to check for code quality:

npm run lint

Testing

Currently, no tests are implemented. You can add tests to the test directory and run them using:

npm test

Configuration

The adapter uses the following default API base URLs:

• MediaWiki API Base: https://en.wikipedia.org/w/api.php
• WikiBase API Base: https://www.wikidata.org/w/api.php

You can override these defaults using the server.configure() method.

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Submit a pull request with a detailed description of your changes.

License

This project is licensed under the LGPL-3.0-or-later license. See the LICENSE file for details.

Author

Created by Luca Mauri.