MCP Wikidata

🚀 MCP Wikidata服務器

這是一個 模型上下文協議（MCP） 服務器，它為大語言模型提供對維基數據（Wikidata）的訪問。

✨ 主要特性

• 5個MCP工具 用於與維基數據進行交互：

  • search_entities：實體的文本搜索
  • get_entity：通過ID詳細檢索實體
  • sparql_query：執行自定義的SPARQL查詢
  • get_relations：探索實體的關係
  • find_by_property：通過屬性 - 值進行搜索

• 支持的API：

  • 維基基礎API（實體的搜索和檢索）
  • SPARQL查詢服務（複雜查詢）
  • 多語言支持和智能緩存

📦 安裝指南

1. 克隆項目

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

2. 安裝依賴

uv sync

3. 測試安裝

uv run python test_connection.py

🚀 快速開始

與Claude桌面版的配置

推薦配置（可移植）

將以下配置添加到您的Claude桌面版文件（在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"
      }
    }
  }
}

💻 使用示例

基礎用法

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請求的用戶代理
WIKIDATA_USER_AGENT=MCP-Wikidata/0.1.0

# 請求速率限制（每分鐘）
WIKIDATA_RATE_LIMIT=60

# 請求超時時間（秒）
WIKIDATA_TIMEOUT=30

# 緩存的TTL（秒）
WIKIDATA_CACHE_TTL=3600

# 每次請求的最大結果數
WIKIDATA_MAX_RESULTS=50

# 默認語言
WIKIDATA_DEFAULT_LANGUAGE=en

調試日誌

若要診斷問題：

uv run mcp-wikidata --log-level DEBUG

故障排除

Claude桌面版中出現 "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桌面版

出現 "spawned uv ENOENT" 錯誤

此錯誤表明Claude桌面版找不到 uv 命令。腳本包裝器 run_mcp_wikidata.sh 會自動解決此問題，它會在多個常見位置查找 uv。

診斷日誌

詳細日誌可在以下位置找到：

• MCP檢查器控制檯
• Claude桌面版日誌文件（取決於您的操作系統）
• MCP服務器的標準錯誤輸出

📚 詳細文檔

項目結構

mcp-wikidata/
  ├ mcp_wikidata/           # 主要包
     ├ __init__.py
     ├ server.py           # 主要的MCP服務器
     ├ config.py           # 配置
     ├ tools.py            # MCP工具定義
     └ wikidata_client.py  # 維基數據API客戶端
  ├ tests/                  # 測試
  ├ run_mcp_wikidata.sh    # 腳本包裝器（推薦）
  ├ test_*.py              # 測試腳本
  ├ pyproject.toml         # 項目配置
  ├ .env.example           # 環境變量
  └ README.md

🤝 貢獻

歡迎大家貢獻代碼！您可以：

• 報告錯誤
• 提出改進建議
• 添加新的MCP工具
• 完善文檔

📄 許可證

本項目採用MIT許可證，更多詳細信息請參閱 LICENSE 文件。

📚 有用的資源

• MCP文檔
• 維基數據API
• SPARQL查詢服務
• uv文檔

由Claude Code生成 🚀