Wikipedia MCP Server

🚀 ウィキペディア MCP サーバー

このサーバーは、Model Context Protocol (MCP) を通じてウィキペディア API とやり取りするためのものです。AI アシスタントがウィキペディアの内容にアクセスし、記事を検索し、歴史的な出来事を取得し、画像を検索することを可能にします。

🚀 クイックスタート

このウィキペディア MCP サーバーは、Model Context Protocol を介してウィキペディア API とのやり取りを可能にするツールです。AI アシスタントがウィキペディアの情報を利用できるようになります。

✨ 主な機能

• onThisDay: 特定の日に起こった歴史的な出来事を取得します。
• findPage: クエリに基づいて一致するウィキペディアのページを検索します。
• getPage: タイトルを指定してウィキペディアのページ内容を取得します。
• getImagesForPage: タイトルを指定してウィキペディアのページ内の画像を取得します。

📦 インストール

npm install @shelm/wikipedia-mcp-server

開発時には以下の手順を実行します。

git clone https://github.com/scotthelm/wikipedia-mcp-server.git
cd wikipedia-mcp-server
npm install
npm run build

💻 使用例

基本的な使用法

サーバーの起動

npx @shelm/wikipedia-mcp-server

これにより、MCP サーバーが起動し、stdio を通じて通信が行われます。

プログラムでの使用

自分のプロジェクトでこのパッケージを直接使用することもできます。

import {
  WikipediaServer,
  isValidOnThisDayArgs,
  isValidFindPageArgs,
  isValidGetPageArgs,
  isValidGetImagesForPageArgs,
} from "@shelm/wikipedia-mcp-server";

// 新しいサーバーインスタンスを作成
const server = new WikipediaServer();

// サーバーを起動
server.run().catch(console.error);

// または、検証関数とハンドラーを直接使用
if (isValidOnThisDayArgs({ date: "2023-01-01" })) {
  const result = await server.handleOnThisDay({ date: "2023-01-01" });
  console.log(result);
}

サンプルクライアントの使用

サーバーとのやり取りの方法を示すサンプルクライアントが用意されています。

node example-client.js

これにより以下の手順が実行されます。

1. サーバーを起動する。
2. 利用可能なツールを問い合わせる。
3. 各ツールのサンプルクエリを実行する。
4. シンプルなウェブインターフェイス http://localhost:3000 で結果を表示する。

🔧 開発

ビルド

npm run build

開発モードでの実行

npm run dev

テスト

サンプルクライアントを手動で使用してテストを行います。

node example-client.js

これにより、利用可能なすべてのツールとそのサンプルクエリが実行されます。

🔧 MCP サーバーの設定

このサーバーを Claude や他の互換性のあるアシスタントと一緒に使用するには、以下のように MCP 設定に追加します。

{
  "mcpServers": {
    "wikipedia": {
      "command": "npx",
      "args": ["@shelm/wikipedia-mcp-server"],
      "env": {}
    }
  }
}

🔗 謝辞

このプロジェクトは、wikipedia package の開発者の皆さんの素晴らしい作品に支えられています。感謝いたします。

📄 ライセンス

MIT