Python MCP Server - Documentation Search

Python MCP Server - Documentation Search

site icon
2025.04.16 0
Python文档搜索开发工具搜索工具开发效率
这是一个基于Python的MCP(Minimal Command Protocol)服务器,主要用于从流行的库(如LangChain、LlamaIndex和OpenAI)中搜索文档。该服务器使用Serper API进行网络搜索,并通过HTTP请求和BeautifulSoup提取相关文档内容。
View on GitHub

Overview

基本能力

产品定位

该服务是一个文档搜索工具,旨在帮助开发者快速获取流行库的文档内容。

核心功能

  • 支持搜索LangChain、LlamaIndex和OpenAI的文档。
  • 使用Serper API执行网络搜索。
  • 提取并返回相关文档页面的文本内容。
  • 可以通过MCP协议交互使用。

适用场景

  • 开发者需要快速查找特定库的文档。
  • 自动化工具需要集成文档搜索功能。
  • 教育和培训场景中需要快速获取技术文档。

工具列表

  • dummy_tool:确认服务器是否正常运行。
  • get_docs:获取指定查询和库的最新文档。

常见问题解答

  • Missing API Key:确保.env文件中正确设置了Serper API Key。
  • Timeout Issues:如果搜索或URL获取超时,尝试增加超时值或检查网络连接。
  • Package Installation Issues:确保所有依赖项已安装且激活了正确的Python环境。

使用教程

使用依赖

  • Python 3.12或更高版本。
  • Serper API Key用于执行网络搜索。
  • MCP库用于服务器和工具执行。
  • BeautifulSoup4和httpx用于HTTP请求和HTML解析。

安装教程

  1. 克隆仓库并安装依赖:
git clone <repository-url>
cd <repository-directory>
pip install -r requirements.txt

或直接安装依赖:

pip install httpx beautifulsoup4 mcp python-dotenv
  1. 设置环境变量: 在项目根目录创建.env文件,并添加:
SERPER_API_KEY=your-serper-api-key-here
  1. 运行服务器:
uv run main.py

调试方式

  1. 启动服务器:
uv run main.py
  1. 在另一个终端或MCP客户端中调用get_docs工具:
get_docs("Chroma DB", "langchain")

这将搜索LangChain文档中的"Chroma DB"并返回相关内容。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。