AI导哈

文档搜索工具

一个基于Python的MCP服务器，通过Serper API搜索并返回框架文档，帮助LLM聊天机器人生成最新结果。

  • by AllanSJoseph
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 allansjoseph/documentation-mcp-server

使用说明

文档MCP服务器

一个简单的基于Python的 MCP（模型上下文协议）服务器 它为LLM聊天机器人提供了一些框架的文档，以便它生成最新的结果。

这是一个在Alejandro AO-Software&Ai的Youtube视频教程的指导下构建的MCP服务器项目。

请参阅此处的视频 使用Python学习MCP服务器（简单）

此MCP服务器的功能

  • 提供名为的工具 文档
  • 用途 Serper 谷歌搜索API，用于搜索文档的特定部分。
  • 从以下文档站点返回文档结果。
  • 使用Beautiful Soup解析结果

如何设置此MCP服务器

先决条件

  • Python 3.8或更高版本
  • uv（MCP服务器的Python包管理器）
  • Serper API密钥（首次登录可获得免费试用版API密钥，信用额度为2000个-> 打开Serper主页)
  • 支持MCP服务器的MCP客户端，例如：Claude Desktop、Cursor、WindSurf等。
  • [可选]Node.js（用于检查MCP服务器）

设置uv

对于Windows用户：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

对于Linux/Mac用户（注意：此服务器在Windows上运行和测试）：

curl -LsSf https://astral.sh/uv/install.sh | sh

设置Serper API密钥，

创建一个 .env 文件，并添加您的Serper API密钥，如

从您的Serper帐户复制api密钥并将其粘贴到 .env 文件如下：

SERPER_API_KEY=your_serper_api_key_here
  1. 打开MCP客户端（此处我使用的是Claude Desktop）。
  2. 转到克劳德设置 Ctrl + ,.
  3. 转到“开发人员”选项卡。
  4. 点击 Edit Config 在本地MCP服务器下。
  5. 它突出了 claude_desktop_config.json 文件，在您最喜欢的文本编辑器中打开它。
  6. 将以下代码添加到 mcp_servers 保存并关闭JSON文件中的列表。
"mcpServers": {
        "documentation": {
            "command": "uv",
            "args": [
                "--directory",
                "your_project_directory_path",
                "run",
                "main.py"
            ]
        }
    }
  1. 重新启动克劳德桌面
  2. 打开一个新的聊天室，点击聊天框上的工具按钮，你会看到 文档 工具可用。
  3. 尝试以下提示：
How do I add and connect a PostgreSQL Database in Django? Use the documentation tool to get the answer.
  1. LLM将使用 文档 搜索答案并在聊天中返回的工具。

请注意，Claude的免费版本对令牌或字符的数量有限制，因此它可能无法提供所需的结果，有时可能会给您超过令牌限制的错误。您可以尝试使用付费版本的Claude或使用其他MCP客户端，如Cursor、WindSurf等。

有关如何在客户端中设置MCP服务器的更多详细信息，请参阅Antropic的官方MCP文档 服务器开发人员-模型上下文协议

检查此MCP服务器

要检查工具并检查工具是否正常工作，请在项目目录的终端中运行以下命令。

npx @modelcontextprotocol/inspector or uv run main.py

感谢Alejandro AO提供的关于构建此MCP服务器的精彩教程和指导。

相关 MCP