@the-pioneer/mediawiki-mcp-server
v0.1.0
Published
あたしが書く README よ。サーバーの概要と使い方をここにぎゅっとまとめておくわね。
Downloads
10
Readme
MediaWiki MCP Server(Written by ツンデレCursor)
あたしが書く README よ。サーバーの概要と使い方をここにぎゅっとまとめておくわね。
何これ?
MediaWiki (Wikipedia など) の API を Model-Context-Protocol (MCP) の tool として公開する TypeScript 製サーバーよ。記事検索やページ取得といった低レベル API 呼び出しを LLM が簡単に叩けるようにするためのブリッジってわけ。
セットアップ
# 依存関係インストール (peer deps 解決のため --legacy-peer-deps)
npm install --legacy-peer-deps;
# TypeScript → JavaScript へビルド
npm run build; # または tsc実行方法
dist/index.js を直接実行するだけ。もう Wiki URL やプレフィックスを CLI で渡す必要は無いわ。サーバーは常に同一バイナリで起動し、クライアント側がツール呼び出し時に wiki フィールドを指定して対象サイトを動的に切り替える設計に変わったの。
# stdio モード(デフォルト)
node dist/index.js;Streamable HTTP モード (MCP Streamable API)
--http フラグを付けると、ポート 3000 で Streamable HTTP (JSON レスポンス, stateless) サーバーを起動するわ。別ポートを使いたいなら --port <番号>。
# ポート 4000 で HTTP サーバーを立てる例
node dist/index.js --http --port 4000;エンドポイントは POST /mcp だけ。JSON-RPC リクエストを POST すれば、レスポンスがそのまま返るシンプル仕様よ。
提供ツール (ベース名)
ベース名は次の 7 種類。
| ベース名 | 説明 | 対応 API |
|----------|------|---------|
| search_pages | ページ全文検索 | action=query&list=search |
| prefix_search | タイトル接頭辞検索 | list=prefixsearch |
| open_search | OpenSearch 互換 | action=opensearch |
| language_search | 言語検索 | action=languagesearch |
| get_page_contents | ページソース取得 | prop=revisions |
| list_all_pages | 全ページ一覧 | list=allpages |
| list_category_members | カテゴリメンバー一覧 | list=categorymembers |
| list_supported_wiki | 内部でサポートしている Wiki 一覧を返す | – |
これらのツールに加えて、すべての API ツールには省略可フィールド wiki が追加されているわ。ここに list_supported_wiki のキー、またはフル URL(https://.../w 形式推奨)を渡すことでターゲット Wiki を切り替えられるの。
MCP プロトコルでの呼び出し
ListTools→list_supported_wikiで候補 Wiki 名と URL を取得。- 任意の API ツール呼び出し時に
{ "wiki": "JapaneseWikipedia", ... }のようにwikiを指定。- 例:
search_pagesに{ "wiki": "JapaneseWikipedia", "query": "人工知能", "limit": 5 }を渡す。
- 例:
ライセンス
MIT (だけど、MediaWiki API が返すコンテンツ自体のライセンスには注意してよね!)
