文档搜索MCP服务器

此模型上下文协议服务器在一个地方提供文档搜索、漏洞审计和项目启动。它作为一个长期运行的过程，服务于MCP兼容客户端（如Claude Desktop或Cursor）的请求。

核心能力

• 聚合超过100个文档来源的语义搜索。
• 扫描本地Python项目中的依赖项漏洞。
• 生成启动框架（FastAPI、React）和开发环境文件。
• 提供学习路径、精选代码示例和库比较。

快速开始

# 需要Python 3.12+
uvx documentation-search-enhanced@latest

配置您的助手以启动服务器：

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "uvx",
      "args": ["documentation-search-enhanced@latest"],
      "env": { "SERPER_API_KEY": "your_serper_api_key_here" }
    }
  }
}

该进程会持续运行并监听JSON-RPC调用；完成时使用Ctrl+C停止它。

开发工作流

git clone https://github.com/antonmishel/documentation-search-mcp.git
cd documentation-search-mcp
uv sync --all-extras --all-groups  # 包括开发工具
echo "SERPER_API_KEY=your_key_here" > .env
uv run python src/documentation_search_enhanced/main.py

• 运行核心测试：uv run pytest --ignore=pytest-test-project。
• 运行示例FastAPI测试：cd pytest-test-project && uv run --all-extras python -m pytest -q。
• 检查代码风格：uv run ruff check src。格式化代码：uv run black src（使用--check来验证）。
• 通过uv build构建分发包；publish_to_pypi.sh封装了发布流程。

配置

向您的助手请求当前配置，通过get_current_config工具保存为config.json，然后调整源或缓存偏好设置。使用uv run python src/documentation_search_enhanced/config_validator.py在本地验证更改。将密钥保存在.env中而不是提交到仓库。

工具概览

关键的MCP工具包括get_docs、semantic_search、get_learning_path、get_code_examples、scan_project_dependencies、generate_project_starter、manage_dev_environment、get_security_summary和compare_library_security。

贡献与许可

从AGENTS.md中的贡献者指南开始，并查看CONTRIBUTING.md中的工作细节。遵循常规提交规范，在拉取请求中记录验证步骤，并更新CHANGELOG.md以反映用户界面的调整。根据MIT许可证发布——详见LICENSE文件中的完整文本。