Document Search MCP Server

🚀 Python MCP 服務器 - 文檔搜索

這是一個簡單的MCP（最小命令協議）服務器，可讓用戶藉助 Serper API，在 LangChain、LlamaIndex 和 OpenAI 等流行庫的文檔中進行搜索。服務器通過HTTP請求和BeautifulSoup從網頁獲取搜索結果，提取相關文檔內容。

✨ 主要特性

• 支持在 LangChain、LlamaIndex 和 OpenAI 的文檔中開展搜索。
• 利用 Serper API 執行網絡搜索。
• 提取並返回相關文檔頁面中的文本內容。
• 可通過MCP協議進行交互式使用。

📦 安裝指南

步驟 1：安裝 Python 依賴項

要設置項目，請克隆此倉庫並安裝所需的依賴項。

git clone <repository-url>
cd <repository-directory>
pip install -r requirements.txt

或者，如果您不使用requirements.txt文件：

pip install httpx beautifulsoup4 mcp python-dotenv

步驟 2：設置環境變量

在項目根目錄中創建一個.env文件，並將您的Serper API密鑰添加到其中。

SERPER_API_KEY=your-serper-api-key-here

確保使用dotenv包加載.env文件。

步驟 3：運行服務器

設置完成後，使用以下命令運行服務器：

uv run main.py

服務器將啟動並等待輸入。

💻 使用示例

基礎用法

一旦服務器運行，您可以使用它來查詢特定庫的最新文檔。以下是工具調用的一個示例： 使用 uv run main.py 啟動服務器。 在另一個終端或從交互式MCP客戶端內部，調用get_docs工具以搜索文檔：

get_docs("Chroma DB", "langchain")

這將在LangChain文檔中搜索"Chroma DB"並返回相關內容。

可用庫

• LangChain：文檔地址為 langchain.com
• LlamaIndex：文檔地址為 llamaindex.ai
• OpenAI：文檔地址為 platform.openai.com

📚 詳細文檔

代碼概述

main.py

• FastMCP：初始化MCP服務器。
• Tools：該服務器有兩個工具：
  • dummy_tool：一個簡單的工具，用於確認服務器是否正常運行。
  • get_docs：獲取給定查詢和庫（LangChain、LlamaIndex、OpenAI）的最新文檔。
• search_web()：處理使用Serper API的搜索。
• fetch_url()：獲取URL並使用BeautifulSoup提取文本內容。

dotenv 和 logging

• 從.env文件中加載Serper API密鑰。
• 提供調試級日誌，以便更好地瞭解服務器操作和潛在問題。