MCP Wikidata

🚀 MCP Wikidata Server

このサーバーは、Model Context Protocol (MCP) を使用して、大規模言語モデルに対してWikidataのデータへのアクセスを提供します。

✨ 主な機能

• 5つのMCPツール を使用してWikidataとやり取りできます。

  • search_entities : エンティティのテキスト検索
  • get_entity : IDによるエンティティの詳細取得
  • sparql_query : カスタムSPARQLクエリの実行
  • get_relations : エンティティの関係の探索
  • find_by_property : プロパティと値による検索

• サポートされるAPI :

  • Wikibase API (エンティティの検索と取得)
  • SPARQL Query Service (複雑なクエリ)
  • 多言語サポートとインテリジェントキャッシュ

📋 前提条件

• Python 3.10以上
• uv (最新のPythonパッケージマネージャー)

📦 インストール

1. プロジェクトをクローンする

git clone https://github.com/joelgombin/mcp-wikidata.git
cd mcp-wikidata

2. 依存関係をインストールする

uv sync

3. インストールをテストする

uv run python test_connection.py

⚙️ Claude Desktopでの設定

推奨設定 (ポータブル)

Claude Desktopの設定ファイル (macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json) に以下の設定を追加します。

{
  "mcpServers": {
    "mcp-wikidata": {
      "command": "/path/to/your/mcp-wikidata/run_mcp_wikidata.sh",
      "args": []
    }
  }
}

重要 : /path/to/your/mcp-wikidata/ を実際のインストールディレクトリの絶対パスに置き換えてください。

uvを直接使用する場合の代替案

スクリプトラッパーを使用しない設定を好む場合は、以下のようにします。

{
  "mcpServers": {
    "mcp-wikidata": {
      "command": "uv",
      "args": ["run", "mcp-wikidata"],
      "cwd": "/path/to/your/mcp-wikidata",
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:~/.local/bin"
      }
    }
  }
}

🧪 テストと検証

MCP Inspectorでテストする

npx @modelcontextprotocol/inspector uv run mcp-wikidata

APIの手動テスト

uv run python test_manual.py

MCPクライアントの完全テスト

uv run python test_mcp_client.py

💻 使用例

基本的な使用法

search_entities

エンティティのテキスト検索:

{
  "query": "Einstein",
  "language": "en",
  "limit": 5,
  "type": "item"
}

get_entity

IDによるエンティティの取得:

{
  "entity_id": "Q937",
  "language": "en", 
  "simplified": true
}

sparql_query

カスタムSPARQLクエリ:

{
  "query": "SELECT ?item ?itemLabel WHERE { ?item wdt:P31 wd:Q5 . SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\" . } } LIMIT 10",
  "format": "json"
}

get_relations

エンティティの関係:

{
  "entity_id": "Q937",
  "relation_type": "outgoing",
  "limit": 20
}

find_by_property

プロパティによる検索:

{
  "property": "P106",
  "value": "physicist",
  "limit": 10
}

⚙️ 高度な設定

環境変数

.env.example を元に .env ファイルを作成します。

# APIリクエストのUser-Agent
WIKIDATA_USER_AGENT=MCP-Wikidata/0.1.0

# リクエストレート制限 (1分あたり)
WIKIDATA_RATE_LIMIT=60

# リクエストのタイムアウト時間 (秒)
WIKIDATA_TIMEOUT=30

# キャッシュのTTL (秒)
WIKIDATA_CACHE_TTL=3600

# 1リクエストあたりの最大結果数
WIKIDATA_MAX_RESULTS=50

# デフォルト言語
WIKIDATA_DEFAULT_LANGUAGE=en

デバッグログ

問題を診断するには、次のコマンドを実行します。

uv run mcp-wikidata --log-level DEBUG

🔧 トラブルシューティング

Claude Desktopで "server disconnected" エラーが発生する場合

1. uvのインストールを確認する :

   which uv
   # /Users/username/.local/bin/uv のようなパスが返されるはず
   

2. スクリプトラッパーをテストする :

   ./run_mcp_wikidata.sh --help
   

3. パーミッションを確認する :

   chmod +x run_mcp_wikidata.sh
   

4. 設定を変更した後、Claude Desktopを再起動する

"spawned uv ENOENT" エラーが発生する場合

このエラーは、Claude Desktopが uv コマンドを見つけられないことを示しています。スクリプトラッパー run_mcp_wikidata.sh は、いくつかの一般的な場所で uv を検索することで、この問題を自動的に解決します。

診断ログ

詳細なログは以下の場所で確認できます。

• MCP Inspectorのコンソール
• Claude Desktopのログファイル (OSによって異なります)
• MCPサーバーのstderr出力

📁 プロジェクト構造

mcp-wikidata/
  ├ mcp_wikidata/           # 主要パッケージ
     ├ __init__.py
     ├ server.py           # 主要MCPサーバー
     ├ config.py           # 設定
     ├ tools.py            # MCPツールの定義
     └ wikidata_client.py  # Wikidata APIクライアント
  ├ tests/                  # テスト
  ├ run_mcp_wikidata.sh    # スクリプトラッパー (推奨)
  ├ test_*.py              # テストスクリプト
  ├ pyproject.toml         # プロジェクト設定
  ├ .env.example           # 環境変数
  └ README.md

🤝 コントリビューション

コントリビューションは大歓迎です！以下のことを自由に行ってください。

• バグ報告
• 改善提案
• 新しいMCPツールの追加
• ドキュメントの改善

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

📚 有用なリソース

• MCPドキュメント
• Wikidata API
• SPARQL Query Service
• uvドキュメント

Claude Codeで生成 🚀