MediaWiki MCP adapter

MediaWikiAdapter

MediaWiki および WikiBase の API と連携するための、カスタム Model Context Protocol (MCP) アダプターです。このアダプターを使用すると、MCP フレームワークを通じて MediaWiki のページをプログラムから取得・編集できます。

特長

• MediaWiki のページの内容を取得します。
• 新しい内容と任意の編集概要を指定して、MediaWiki のページを編集します。
• さまざまな MediaWiki および WikiBase インスタンスに対応する API のベース URL を設定できます。

必要条件

• Node.js（v16 以降）
• TypeScript（開発用）
• API アクセスが有効になっている MediaWiki インスタンス

インストール

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

使用方法

アダプターの設定

カスタムの MediaWiki および WikiBase API エンドポイントを使用するように、アダプターを設定できます：

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

MCP サーバーの起動

次のコマンドを使用して MCP サーバーを実行します：

node build/index.js

リソース

getPageContent

MediaWiki のページの内容を取得します。

• 入力スキーマ：

  {
    "title": "string"
  }

• 出力スキーマ：

  {
    "content": "string"
  }
  

使用例：

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

---

ツール

editPage

新しい内容で MediaWiki のページを編集します。

• 入力スキーマ：

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

• 出力スキーマ：

  {
    "success": "boolean"
  }

使用例：

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

---

開発

開発モードで実行

TypeScript を使用してプロジェクトを開発モードで実行するには：

npm run dev

リント

コード品質を確認するには、リンターを実行します：

npm run lint

テスト

現在、テストは実装されていません。test ディレクトリにテストを追加し、次のコマンドで実行できます：

npm test

---

設定

このアダプターでは、次の API ベース URL がデフォルトで使用されます：

• MediaWiki API ベース： https://en.wikipedia.org/w/api.php
• WikiBase API ベース： https://www.wikidata.org/w/api.php

server.configure() メソッドを使用して、これらのデフォルト値を上書きできます。

---

コントリビューション

コントリビューションを歓迎します！次の手順に従ってください：

1. リポジトリをフォークします。
2. 機能追加またはバグ修正用の新しいブランチを作成します。
3. 変更内容を詳しく説明したプルリクエストを送信します。

---

ライセンス

このプロジェクトは LGPL-3.0-or-later ライセンスの下で提供されています。詳細については、LICENSE ファイルをご覧ください。

---

作成者

Luca Mauri によって作成されました。