🚀 Python MCP 服务器 - 文档搜索
这是一个简单的MCP（最小命令协议）服务器，可让用户借助 Serper API，在 LangChain、LlamaIndex 和 OpenAI 等流行库的文档中进行搜索。服务器通过HTTP请求和BeautifulSoup从网页获取搜索结果，并提取相关文档内容。
🚀 快速开始
本服务器允许用户通过 Serper API 从流行库中搜索文档，使用HTTP请求和BeautifulSoup提取网页内容。以下将详细介绍如何安装和使用该服务器。
✨ 主要特性
- 支持在 LangChain、LlamaIndex 和 OpenAI 的文档中进行搜索。
- 使用 Serper API 执行网络搜索。
- 提取并返回相关文档页面中的文本内容。
- 可通过MCP协议交互式使用。
📦 安装指南
步骤 1：安装 Python 依赖项
要设置项目，请克隆此仓库并安装所需的依赖项。
git clone
cd
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 密钥。 - 提供调试级日志，以便更好地了解服务器操作和潜在问题。