使用说明
MCP文档搜索服务器
该项目实现了一个自定义MCP(模型控制协议)服务器,使Claude能够在文档中搜索流行的Python库,包括LangChain、LlamaIdex和OpenAI。
特性
- 在支持的库中搜索特定查询的文档
- 通过Serper与Google Search API集成以查找相关文档页面
- 从文档页面提取内容的Web抓取功能
- 设计用于通过MCP与Claude Desktop配合使用
系统要求
- Python 3.10或更高版本
- MCP SDK 1.2.0或更高版本
uv包管理器
入门指南
安装uv包管理器
在MacOS/Linux上:
curl -LsSf https://astral.sh/uv/install.sh | sh
在Windows上:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
确保之后重新启动终端,以确保 uv 命令被接收。有关uv包装管理器的更多信息,请访问: https://docs.astral.sh
项目设置
- 创建并初始化项目:
# Create a new directory for our project
uv init mcp-server
cd mcp-server
# Create virtual environment and activate it
uv venv
source .venv/bin/activate # On Windows use: .venv\Scripts\activate
# Install dependencies
uv add "mcp[cli]" httpx
- 创建服务器实现文件:
touch main.py
运行服务器
- 启动MCP服务器:
uv run main.py
- 服务器将启动并准备接受连接
连接到克劳德桌面
- 从官方网站安装Claude Desktop
- 配置Claude Desktop以使用您的MCP服务器:
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-server": {
"command": "uv", # It's better to use the absolute path to the uv command
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/YOUR/mcp-server",
"run",
"main.py"
]
}
}
}
- 重新启动克劳德桌面
故障排除
如果您的服务器未被Claude Desktop接收:
- 检查配置文件路径和权限
- 验证配置中的绝对路径是否正确
- 确保紫外线正确安装且易于接近
- 检查Claude Desktop日志中是否有任何错误消息