什么是Cursor MCP

MCP (Model Context Protocol) 是由Anthropic公司开发的协议,旨在让大型语言模型(LLM)能够安全地与外部工具和服务交互。Cursor作为先进的AI编程工具,集成了MCP功能,允许Cursor连接自定义AI模型服务器,扩展AI助手能力,连接第三方服务(GitHub、Jira等)。通过MCP,AI助手能够获取实时数据、执行特定操作,大大增强了其实用性和功能范围。

配置步骤

1. 打开MCP配置界面

  1. 打开Cursor
  2. 点击左下角设置图标或使用快捷键 Ctrl+Shift+P(Windows)/Cmd+Shift+P(Mac)
  3. 搜索并选择”Cursor Settings”
  4. 在左侧边栏选择”MCP”

2. 添加MCP服务器

在MCP Servers部分,点击”Add new MCP server”,推荐配置以下三个服务器:

2.1 GitHub MCP Server

  • Name: GitHub
  • Type: command
  • Command: npx -y @modelcontextprotocol/server-github

主要功能

  • 文件操作:创建、更新文件,提交多个文件
  • 仓库管理:搜索、创建仓库,管理分支
  • Issue和PR:创建、更新、评论Issue,管理PR
  • 代码搜索:按语言、路径、文件类型搜索代码

配置GitHub令牌

  • 在GitHub创建个人访问令牌(需要repo权限)
  • 使用环境变量: GITHUB_PERSONAL_ACCESS_TOKEN=你的令牌

2.2 Atlassian MCP Server

  • Name: Atlassian
  • Type: command
  • Command: uvx mcp-atlassian --confluence-url=https://your-domain.atlassian.net/wiki --confluence-username=你的邮箱 --confluence-token=你的令牌 --jira-url=https://your-domain.atlassian.net --jira-username=你的邮箱 --jira-token=你的令牌

先安装uvx:pip install uv

主要功能

  • Confluence:搜索内容,获取/创建/更新/删除页面
  • Jira:查询issue,创建/更新任务,状态转换,添加工作日志
  • 项目管理:链接issue到Epic,获取项目的所有issue

配置Atlassian令牌

2.3 Time MCP Server

  • Name: Time
  • Type: command
  • Command: npx -y @modelcontextprotocol/server-time

也可使用:uvx mcp-server-time

主要功能

  • 获取当前时间:获取特定时区或系统时区的当前时间
  • 时区转换:在不同时区之间转换时间
  • 自定义时区:支持设置默认时区(如--local-timezone=Asia/Shanghai

3. 完整配置示例

以下是三个MCP服务器的完整配置示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github token",
"GITHUB_USERNAME": "github username"
}
},
"atlassian": {
"command": "uvx",
"args": [
"mcp-atlassian"
],
"env": {
"JIRA_URL": "https://<jira url>",
"JIRA_USERNAME": "jira username",
"JIRA_PERSONAL_TOKEN": "jira token"
}
},
"time": {
"command": "uvx",
"args": [
"mcp-server-time",
"--local-timezone=Asia/Shanghai"
]
}
}
}

windows下配置需要特别注意command需要全路径,如

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
"mcpServers": {
"github": {
"command": "cmd",
"args": [
"/c",
"npx -y @modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github token",
"GITHUB_USERNAME": "github username"
}
},
"filesystem": {
"command": "C:\\nodejs\\node.exe",
"args": [
"C:\\Users\\admin\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
"D:\\"
]
},
"time": {
"command": "C:\\Users\\admin\\.local\\bin\\uvx.exe",
"args": [
"mcp-server-time",
"--local-timezone=Asia/Shanghai"
]
}
}
}

4. 验证配置

添加服务器后,服务器状态应显示为绿色,表示连接成功。黄色状态时,尝试刷新或重启Cursor。

MCP Status

5. 使用MCP功能

配置完成后:

  1. 在Agent模式下使用MCP功能
  2. 在聊天窗口指示AI使用MCP工具,例如”使用GitHub创建一个新仓库”
  3. 在提示时选择接受

常见问题

  1. 服务器显示黄色状态:尝试刷新或重启Cursor
  2. 命令执行失败:确认已安装Node.js,检查网络连接
  3. 工具未显示:确认使用Agent模式,重启Cursor
  4. 权限问题:确保API令牌正确且有足够权限

总结

通过配置MCP,可以显著扩展Cursor功能,提高开发效率。推荐的三个服务器(GitHub、Atlassian和Time)满足开发者日常多种需求。

参考资料:


本文由 AI 辅助生成,如有错误或建议,欢迎指出。