Grokipedia MCP

🚀 Grokipedia MCP Server

Grokipedia MCP Server 是一個用於從 Grokipedia 搜索和檢索內容的服務器。用戶在與 Grokipedia 進行交互時需承擔全部責任。若有任何疑問，請參閱 Xai 服務條款。

🚀 快速開始

將以下內容添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "grokipedia": {
      "command": "uvx",
      "args": ["grokipedia-mcp"]
    }
  }
}

驗證安裝

您可以通過以下工具查看 Grokipedia 服務器是否可用：

• search - 帶過濾條件的搜索
• get_page - 獲取頁面概述
• get_page_content - 獲取完整內容
• get_page_citations - 獲取引用
• get_related_pages - 獲取鏈接頁面
• get_page_sections - 列出所有章節標題
• get_page_section - 提取特定章節

以及以下提示詞：

• research_topic - 研究工作流程
• find_sources - 查找引用
• explore_related - 探索關聯內容
• compare_topics - 比較兩個主題

✨ 主要特性

• 帶過濾條件的搜索：支持按相關性或瀏覽量排序，以及按最小瀏覽量過濾。
• 頁面內容獲取：可檢索文章、引用和元數據，並進行智能截斷。
• 相關頁面發現：能發現鏈接或相關的文章。
• 章節提取：可從長篇文章中提取特定章節。
• 智能建議：當頁面未找到時提供有用的替代建議。
• 引導式提示詞：提供預建的研究、查找引用和探索關聯內容的工作流程。

📦 安裝指南

開發環境安裝

使用 uv 進行安裝：

cd grokipedia-mcp
uv sync

若要使用 MCP Inspector 和 CLI 工具進行開發：

uv sync --dev

💻 使用示例

使用 MCP Inspector 運行（開發環境）

這是測試和調試的最快方法（需要開發依賴）：

uv run --dev mcp dev main.py

運行上述命令後，會啟動 MCP Inspector UI，您可以在其中：

• 探索可用工具
• 測試搜索查詢
• 檢索頁面內容
• 查看結構化輸出

直接運行

# 使用已安裝的入口點
uv run grokipedia-mcp

# 或作為 Python 模塊運行
uv run python -m grokipedia_mcp

# 或直接運行
uv run python main.py

可用工具示例

search

在 Grokipedia 中搜索文章，支持過濾和排序選項。

參數：

• query（字符串，必需） - 搜索查詢詞
• limit（整數，可選，默認值：12） - 最大結果數
• offset（整數，可選，默認值：0） - 分頁偏移量
• sort_by（字符串，可選，默認值："relevance"） - 按 "relevance" 或 "views" 排序
• min_views（整數，可選） - 過濾出至少有指定瀏覽量的文章

返回值：包含標題、slug、摘要、相關性得分和瀏覽量的搜索結果列表。

示例：

// 基本搜索
{"query": "machine learning", "limit": 5}

// 按瀏覽量排序
{"query": "python", "sort_by": "views"}

// 僅過濾熱門文章
{"query": "artificial intelligence", "min_views": 1000}

get_page

獲取完整的頁面信息，包括元數據、內容預覽和引用摘要。如果頁面未找到，會提供智能的替代建議。

參數：

• slug（字符串，必需） - 文章標識符（來自搜索結果）
• max_content_length（整數，可選，默認值：5000） - 最大內容長度

返回值：包含元數據、截斷內容和引用摘要的完整頁面對象。

特性：

• 如果請求的 slug 不存在，會建議類似頁面
• 提供包含內容預覽和引用的概述

適用場景：當您需要帶有元數據和內容預覽的頁面概述時使用。

示例：

{"slug": "Machine_learning"}

get_page_content

僅獲取文章內容，不包含引用或元數據。

參數：

• slug（字符串，必需） - 文章標識符
• max_length（整數，可選，默認值：10000） - 最大內容長度

返回值：僅包含文章內容（標題和內容文本）。

適用場景：當您需要閱讀不包含引用的完整文章內容時使用。

示例：

{"slug": "Machine_learning", "max_length": 15000}

get_page_citations

獲取特定頁面的引用列表。

參數：

• slug（字符串，必需） - 文章標識符
• limit（整數，可選） - 要返回的最大引用數（如果未指定，則返回所有引用）

返回值：包含標題、URL 和描述的引用列表。包括總數和返回數。

適用場景：當您需要訪問源引用和引用時使用。

示例：

// 獲取所有引用
{"slug": "Machine_learning"}

// 僅獲取前 10 個引用
{"slug": "Machine_learning", "limit": 10}

get_related_pages

獲取特定文章鏈接的頁面。

參數：

• slug（字符串，必需） - 文章標識符
• limit（整數，可選，默認值：10） - 要返回的最大相關頁面數

返回值：包含標題和 slug 的相關/鏈接頁面列表。

適用場景：當您想發現相關主題或探索文章之間的關聯時使用。

示例：

// 獲取相關頁面
{"slug": "Machine_learning"}

// 獲取更多相關頁面
{"slug": "Quantum_computing", "limit": 20}

get_page_sections

獲取文章中所有章節標題的列表。

參數：

• slug（字符串，必需） - 文章標識符

返回值：包含所有章節標題及其級別（h1、h2、h3 等）的列表。

適用場景：當您想在閱讀特定章節之前查看文章的結構/大綱時使用。

示例：

{"slug": "Machine_learning"}

get_page_section

按標題名稱從文章中提取特定章節。

參數：

• slug（字符串，必需） - 文章標識符
• section_header（字符串，必需） - 要提取的章節標題（不區分大小寫）
• max_length（整數，可選，默認值：5000） - 最大章節內容長度

返回值：僅包含指定章節的內容。

適用場景：當您只需要長篇文章的一個章節（例如，"應用"、"歷史"、"示例"）時使用。

示例：

// 獲取特定章節
{"slug": "Neural_networks", "section_header": "Applications"}

// 獲取更長的章節
{"slug": "Python", "section_header": "Syntax", "max_length": 10000}

注意：文章可能超過 100,000 個字符。為防止超出大語言模型的上下文窗口，內容會自動截斷。您可以使用 max_length 參數控制返回的內容量。

提示詞示例

服務器提供了用於常見工作流程的預建提示詞：

research_topic

引導式工作流程，用於研究主題：搜索 → 檢索 → 分析相關頁面和引用

find_sources

為學術/研究目的查找權威來源和引用

explore_related

發現主題之間的關聯並獲取推薦的進一步閱讀內容

compare_topics

並排比較兩個主題的內容和引用

🔧 技術細節

架構

服務器使用了以下技術：

• FastMCP 用於聲明式 MCP 服務器實現
• grokipedia-api-sdk AsyncClient 用於 API 通信
• Lifespan context 用於客戶端連接管理
• Structured output 使用 SDK 中的 Pydantic 模型
• Comprehensive error handling 具備特定的異常類型

錯誤處理

服務器處理各種錯誤場景：

• ValueError 用於處理無效參數或頁面未找到的情況
• RuntimeError 用於處理網絡或 API 錯誤
• 支持詳細的調試、信息、警告和錯誤級別的日誌記錄

開發

項目結構

grokipedia-mcp/
├── grokipedia_mcp/
│   ├── __init__.py       # 包導出
│   ├── __main__.py       # CLI 入口點
│   └── server.py         # FastMCP 服務器實現
├── main.py               # 直接執行入口點
├── pyproject.toml        # 項目配置
└── README.md             # 本文件

測試

使用 MCP Inspector 進行交互式測試：

uv run mcp dev main.py

📄 許可證

本項目採用 MIT 許可證。