Python MCP Server 8u4

🚀 Python MCP 服務器 - 文檔搜索

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

🚀 快速開始

本 Python MCP 服務器可幫助你從流行庫中搜索文檔。按以下步驟操作，即可快速開啟搜索之旅。

✨ 主要特性

• 支持在 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 密鑰。
• 提供調試級別日誌，以更好地瞭解服務器操作和潛在問題。