python-mcp-server

Python MCP 服务 - 文档搜索

这是一个简单的 MCP（最小命令协议）服务，用户可以使用 Serper API 搜索 LangChain、LlamaIndex 和 OpenAI 等热门库的文档。服务会获取搜索结果，并通过 HTTP 请求和 BeautifulSoup 从网页中提取相关文档。

功能

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

要求

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

安装

步骤 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 Key。

SERPER_API_KEY=your-serper-api-key-here

确保使用 dotenv package 加载 .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: Initializes the MCP server.
• Tools: The server has two tools:
• dummy_tool: A simple tool that confirms the server is up and running.
• get_docs: Fetches the latest documentation for a given query and library (LangChain, LlamaIndex, OpenAI).
• search_web(): Handles searching using the Serper API.
• fetch_url(): Fetches a URL and extracts the text content using BeautifulSoup.

dotenv and logging

• Loads the Serper API Key from the .env file.
• Provides debug-level logging for better visibility into server actions and potential issues.`````

Troubleshooting

• Missing API Key: Make sure the Serper API Key is set correctly in the .env file. You’ll get an error if it's missing.
• Timeout Issues: If a search or URL fetch times out, try increasing the timeout values or checking the network connectivity.
• Package Installation Issues: Ensure all dependencies are installed and the correct Python environment is activated.

Contributor

Udayan Sawant