MCP服务器
使用MCP SDK的Claude Desktop服务器实现。
系统要求
- Python 3.10或更高版本
- MCP SDK 1.2.0或更高版本
- uv包管理器
入门指南
安装uv包管理器
在MacOS/Linux上:
curl -LsSf https://astral.sh/uv/install.sh | sh确保之后重新启动终端,以确保收到uv命令。
项目设置
- 初始化项目:
# 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 python-dotenv beautifulsoup4- 配置环境变量:
# Create a .env file
touch .env
# Add your Serper API key
echo "SERPER_API_KEY=your_api_key_here" >> .env您可以通过在注册获得Serper API密钥 瑟珀·德夫.
运行服务器
启动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日志中是否有任何错误消息
- 验证您的
.env文件存在并包含所需的SERPER_API_KEY
