CURSOR_SETUP.md•4.13 kB
# Serena 与 Cursor IDE 集成指南
## 概述
本指南将帮助您在 Cursor IDE 中配置和使用 Serena MCP 服务器，让您在编码时享受强大的 AI 辅助功能。
## 前置条件
✅ Python 3.11 已安装
✅ uv 包管理器已安装
✅ Serena 项目依赖已安装
✅ Cursor IDE 已安装
## 配置步骤
### 1. 在 Cursor 中启用 MCP 支持
1. 打开 Cursor IDE
2. 进入设置 (Ctrl+,)
3. 搜索 "MCP" 或 "Model Context Protocol"
4. 确保 MCP 功能已启用
### 2. 配置 MCP 服务器
#### 方法一：使用配置文件
1. 在 Cursor 设置中找到 MCP 服务器配置选项
2. 导入或复制 `cursor_mcp_config.json` 文件内容
#### 方法二：手动配置
在 Cursor 的 MCP 设置中添加以下配置：
```json
{
"mcpServers": {
"serena": {
"command": "py",
"args": [
"-3.11",
"-m",
"uv",
"run",
"--directory",
"H:\\AI\\Serena\\serena-main",
"serena-mcp-server",
"--context",
"ide-assistant",
"--mode",
"interactive",
"--mode",
"editing"
],
"env": {
"UV_INDEX_URL": "https://mirrors.aliyun.com/pypi/simple/"
}
}
}
}
```
### 3. 验证配置
1. 重启 Cursor IDE
2. 打开一个项目
3. 在 AI 聊天界面中输入：`@serena 激活项目 [你的项目路径]`
4. 如果看到 Serena 响应，说明配置成功
## 使用方法
### 激活项目
首次使用时，需要激活您的项目：
```
@serena 激活项目 C:\path\to\your\project
```
### 常用命令
#### 代码分析
- `@serena 分析这个文件的结构`
- `@serena 查找所有引用了 [函数名] 的地方`
- `@serena 显示 [类名] 的所有方法`
#### 代码编辑
- `@serena 重构这个函数，使其更易读`
- `@serena 在 [位置] 插入 [代码]`
- `@serena 替换 [旧代码] 为 [新代码]`
#### 项目导航
- `@serena 搜索包含 [关键词] 的文件`
- `@serena 列出项目中的所有类`
- `@serena 显示项目结构`
### 高级功能
#### 语义搜索
Serena 提供基于语义的代码搜索，比传统的文本搜索更智能：
```
@serena 找到所有处理用户认证的代码
@serena 搜索数据库连接相关的函数
```
#### 符号级编辑
Serena 可以精确地在符号级别进行编辑：
```
@serena 在 UserService 类中添加新方法
@serena 修改 authenticate 函数的参数
```
## 故障排除
### 常见问题
#### 1. MCP 服务器启动失败
- 检查 Python 3.11 是否正确安装：`py -3.11 --version`
- 验证 uv 是否可用：`py -3.11 -m uv --version`
- 确认项目路径正确
#### 2. 无法连接到 Serena
- 重启 Cursor IDE
- 检查 MCP 配置中的路径是否正确
- 查看 Cursor 的错误日志
#### 3. 性能问题
- 对大型项目，建议先建立索引：
```bash
cd your-project
py -3.11 -m uv run --directory H:\AI\Serena\serena-main index-project
```
### 日志和调试
启用详细日志：
```json
{
"mcpServers": {
"serena": {
"command": "py",
"args": [
"-3.11", "-m", "uv", "run",
"--directory", "H:\\AI\\Serena\\serena-main",
"serena-mcp-server",
"--context", "ide-assistant",
"--mode", "interactive",
"--mode", "editing",
"--log-level", "DEBUG"
]
}
}
}
```
## 性能优化建议
1. **项目索引**：对于大型项目，预先建立索引可显著提升响应速度
2. **模式选择**：根据需要选择合适的模式（interactive、editing、planning）
3. **内存管理**：定期重启 MCP 服务器以释放内存
## 支持的编程语言
Serena 通过语言服务器支持多种编程语言：
- ✅ Python（完全支持）
- ✅ TypeScript/JavaScript
- ✅ PHP
- ✅ Go
- ✅ Rust
- ✅ C#
- ✅ Java
- ✅ C/C++
- ✅ Clojure
## 更多资源
- [Serena 官方文档](https://github.com/oraios/serena)
- [MCP 协议说明](https://modelcontextprotocol.io/)
- [Cursor IDE 文档](https://cursor.sh/docs)
---
配置完成后，您就可以在 Cursor 中享受 Serena 提供的强大 AI 编码辅助功能了！