MCP Documentation Search Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

MCP Documentation Search Server 是一个专为 AI 系统设计的文档搜索工具，支持跨多个流行框架和库的智能搜索。

核心功能

• 多库支持：支持搜索多个库的文档，包括 LangChain、LangGraph、Next.js、Tailwind CSS、FastMCP 和 Framer Motion。
• 智能搜索：
• 智能解析库名称变体
• 使用 DuckDuckGo 进行精确搜索
• 针对特定站点的搜索
• 性能优化：
• 异步处理
• 高效的网络请求处理
• 并行内容获取
• 健壮的错误处理：
• 网络超时管理
• 无效输入验证
• HTTP 错误处理
• 请求失败恢复

适用场景

• AI 系统需要快速访问多个文档源
• 开发者在开发过程中需要跨库搜索文档
• 需要高效、智能的文档检索工具

工具列表

• get_docs：主 API 函数，用于搜索文档
• Library Name Variations：智能处理库名称变体

常见问题解答

• TimeoutError：增加 HTTP_TIMEOUT 设置
• No Results：尝试不同的搜索词或验证库名称
• HTTP Errors：检查网络连接和文档 URL

使用教程

使用依赖

• Python 3.8+
• pip 或 uv 包管理器
• 虚拟环境（推荐）

安装教程

1. 克隆仓库
   bash
git clone <repository-url>
cd mcp-server
2. 设置虚拟环境
   ```bash
   python -m venv .venv

Windows:

.venv\Scripts\activate

Unix/MacOS:

source .venv/bin/activate
3. **安装依赖**bash
pip install -r requirements.txt
4. **运行服务器**bash
python main.py
```

调试方式

• 运行测试
  bash
python -m pytest
• 运行特定测试模块
  bash
python -m pytest tests/test_utils.py
python -m pytest tests/test_services.py
python -m pytest tests/test_main.py
• 详细输出测试
  bash
python -m pytest -v