Cursor 中集成 MCP 服务实战指南
随着 AI 编程助手的普及,开发者越来越倾向于在 Cursor 这类智能 IDE 中进行高效开发。除了基础的代码补全和搜索,Cursor 通过 MCP(Model Context Protocol)协议,能够轻松调用高德地图 API、数据库等多种外部服务,实现数据采集、处理和自动化办公。
本文以'北京一日游自动化攻略'为例,详细讲解如何在 Cursor 中配置并使用 MCP 服务,完成从数据获取到前端展示的全流程。
环境准备
1. Node.js 与 npm/npx
MCP Server 大多基于 Node.js 运行。请确保已安装 Node.js 并配置好环境变量。
2. Python 与 uv
部分工具链依赖 Python 环境。如果未配置,可通过以下命令安装:
pip install uv
Windows 用户若需快速安装,可运行:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
安装完成后,使用 uv --version 检查版本。
配置 MCP Server
在 Cursor 中添加 MCP Server 主要有两种方式:全局配置或项目级配置。推荐在项目目录下进行配置,避免影响其他工作区。
1. 创建配置文件
在项目根目录新建 .cursor 文件夹,并在其中创建 mcp.json 文件。
2. 添加服务示例
这里以 MySQL、高德地图和文件系统为例。你需要先在对应平台申请必要的 Key 或权限。
MySQL 服务 需提前创建好数据库。配置信息通常来自官方文档或社区仓库(如 Smithery),直接复制 JSON 结构即可。
注意:粘贴后建议核对 GitHub 源链接,确保参数无误。
高德地图服务 需前往 高德开放平台 申请 API Key。
文件系统服务 用于读写本地文件,需指定允许访问的目录路径。
3. 完整配置参考
将以下内容填入 mcp.json,并根据实际环境修改密码、Key 和路径:
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@f4ww4z/mcp-mysql-server"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "你的数据库密码",
"MYSQL_DATABASE": "beijing_trip"
}
},
"amap-maps": {
"command": "npx",
"args": ["-y", "@amap/amap-maps-mcp-server"],
"env": {
"AMAP_MAPS_API_KEY": "你的高德 Key"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/DESKTOP/MCP"]
}
}
}
配置完成后,打开 Cursor 设置中的 MCP 面板,确认服务状态显示为绿色且 Enabled。
实战测试
配置就绪后,无需手动编写 SQL 或 HTTP 请求,直接在对话框中输入自然语言指令即可。
提示词示例
现在交给你一个任务,编写一个北京一日游的出行攻略:
1. 从高德地图 MCP 服务中获取北京站到天安门、天安门到颐和园、颐和园到南锣鼓巷的地铁线路,并保存在数据库 beijing_trip 的表 subway_trips 中。
2. 从高德地图 MCP 中获取颐和园、南锣鼓巷附近的美食信息,每处获取三家店铺信息,存入表 location_foods 中。
3. 在工作目录 D:\DESKTOP\MCP 下创建新文件夹'北京旅行',将两个表的内容导出为 txt 文件。
4. 根据 txt 内容,生成一个精美的 HTML 前端展示页面。
执行效果
- 自动建表:AI 会自动连接数据库并执行建表语句,无需手动写 DDL。
- 数据填充:调用高德 API 获取经纬度及换乘方案,自动 INSERT 数据。
- 文件操作:自动读取数据库内容,写入文本文件,并生成 HTML 页面。
生成的表结构大致如下:
create table location_foods (
id int auto_increment primary key,
location varchar(64) not null,
name varchar(128) not null,
address varchar(256) null,
tel varchar(64) null,
type varchar(64) null,
distance varchar(32) null
);
create table subway_trips (
id int auto_increment primary key,
start_location varchar(64) not null,
end_location varchar(64) not null,
subway_lines text not null,
duration varchar(32) null,
distance varchar(32) null
);
实用 Tips
- 权限管理:确保 MCP 服务拥有正确的 API Key 和数据库读写权限。
- 路径安全:文件操作限制在允许的目录内,否则可能触发
Access denied。 - 密钥保护:敏感信息(如数据库密码、API Key)建议通过环境变量注入,不要硬编码在配置文件中。
结语
在 Cursor 中结合 MCP 服务和 AI 助手,能极大提升开发和数据处理效率。无论是地图数据采集、数据库管理,还是自动化生成前端页面,都能一站式完成。这种工作流让 AI 真正成为了开发过程中的得力助手。

