Adaptador MediaWiki

Un adaptador personalizado del Protocolo de Contexto de Modelo (MCP) para interactuar con las API de MediaWiki y WikiBase. Este adaptador permite obtener y editar páginas de MediaWiki mediante programación utilizando el marco MCP.

Características

Obtener el contenido de una página de MediaWiki.
Editar una página de MediaWiki con contenido nuevo y un resumen opcional.
URL base de API configurables para diferentes instancias de MediaWiki y WikiBase.

Requisitos

Node.js (v16 o posterior)
TypeScript (para desarrollo)
Instancia de MediaWiki con acceso API habilitado

Instalación

Clonar el repositorio:

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

Instalar dependencias:
npm install
Construir el proyecto:
npm run build

Uso

Configurar el adaptador

Puede configurar el adaptador para utilizar puntos finales de API MediaWiki y WikiBase personalizados:

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

Iniciar el servidor MCP

Ejecute el servidor MCP utilizando el siguiente comando:

node build/index.js

Recursos

obtenerContenidoDePágina

Obtiene el contenido de una página de MediaWiki.

Esquema de entrada :

  {
    "title": "string"
  }

Esquema de salida :
{ "content": "string" }

Ejemplo de uso:

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

Herramientas

editar página

Edita una página de MediaWiki con contenido nuevo.

Esquema de entrada :

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

Esquema de salida :

  {
    "success": "boolean"
  }

Ejemplo de uso:

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

Desarrollo

Ejecutar en modo de desarrollo

Para ejecutar el proyecto en modo de desarrollo con TypeScript:

npm run dev

Pelusa

Ejecute el linter para comprobar la calidad del código:

npm run lint

Pruebas

Actualmente no hay pruebas implementadas. Puedes agregar pruebas al directorio test y ejecutarlas usando:

npm test

Configuración

El adaptador utiliza las siguientes URL base de API predeterminadas:

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

Puede anular estos valores predeterminados mediante el método server.configure() .

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

Bifurcar el repositorio.
Crea una nueva rama para tu característica o corrección de error.
Envíe una solicitud de extracción con una descripción detallada de sus cambios.

Licencia

Este proyecto está licenciado bajo la licencia LGPL-3.0 o posterior . Consulte el archivo de LICENCIA para obtener más información.

Autor

Creado por Luca Mauri .

MediaWiki MCP adapter

Integrations

Adaptador MediaWiki

Características

Requisitos

Instalación

Uso

Configurar el adaptador

Iniciar el servidor MCP

Recursos

obtenerContenidoDePágina

Ejemplo de uso:

Herramientas

editar página

Ejemplo de uso:

Desarrollo

Ejecutar en modo de desarrollo

Pelusa

Pruebas

Configuración

Contribuyendo

Licencia

Autor