MediaWiki Adapter

MediaWiki Adapter

What is MediaWiki Adapter about?

Enables interaction with MediaWiki and WikiBase instances via the Model Context Protocol, exposing resources to retrieve page content and tools to edit pages programmatically.

How to use MediaWiki Adapter?

1. Clone and install

   git clone https://github.com/lucamauri/MediaWiki-MCP-adapter.git
   cd MediaWiki-MCP-adapter
   npm install
   npm run build
   

2. Configure API endpoints (optional)

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

3. Start the MCP server

   node build/index.js
   

4. Call resources/tools from a client:

   const page = await server.callResource("getPageContent", { title: "Main Page" });
   console.log(page.content);
   
   const editResult = await server.callTool("editPage", {
     title: "Main Page",
     content: "Updated content",
     summary: "Updated via MediaWiki Adapter"
   });
   console.log(editResult.success ? "Edit successful" : "Edit failed");
   

Key features of MediaWiki Adapter

• Fetch page content via the getPageContent resource.
• Edit pages with optional edit summary via the editPage tool.
• Configurable API base URLs for multiple MediaWiki/WikiBase instances.
• TypeScript‑based codebase with build and development scripts.
• LGPL‑3.0‑or‑later licensing, suitable for open‑source integration.

Use cases of MediaWiki Adapter

• Automated content updates for wikis (e.g., bot‑driven maintenance).
• Integration of wiki data into external applications or AI pipelines.
• Bulk import/export of wiki pages in a controlled, programmatic way.
• Custom dashboards that display live wiki page contents.
• Educational tools that need to read or modify wiki lessons on demand.

FAQ from the MediaWiki Adapter

Q: Which Node.js version is required? A: Node.js v16 or later.

Q: Is there a test suite? A: No tests are currently shipped; you can add them under the test directory and run npm test.

Q: How do I contribute? A: Fork the repository, create a feature/bug‑fix branch, and submit a pull request with a clear description.

Q: Can I use the default Wikipedia API? A: Yes, the default MediaWiki API base is https://en.wikipedia.org/w/api.php and the default WikiBase API base is https://www.wikidata.org/w/api.php.

Q: What license governs the project? A: LGPL‑3.0‑or‑later.

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.