MCP Documentation Search Server

基本能力

产品定位

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. 克隆仓库

git clone <repository-url>
cd mcp-server

1. 设置虚拟环境

python -m venv .venv
# Windows:
.venv\Scripts\activate
# Unix/MacOS:
source .venv/bin/activate

1. 安装依赖

pip install -r requirements.txt

1. 运行服务器

python main.py

调试方式

• 运行测试

python -m pytest

• 运行特定测试模块

python -m pytest tests/test_utils.py
python -m pytest tests/test_services.py
python -m pytest tests/test_main.py

• 详细输出测试

python -m pytest -v

许可证

该项目遵循 MIT 开源许可条款。