Cursor 集成 MCP 服务实战指南
随着 AI 编程助手的普及,开发者越来越倾向于在 Cursor 这类智能 IDE 中工作。除了基础的代码补全和搜索,Cursor 通过 MCP(Model Context Protocol)模型上下文协议,能够直接调用地图、数据库等外部服务,实现数据采集与自动化处理。
本文以'北京一日游自动化攻略'为例,演示如何配置 MCP 服务,完成从数据获取、存储到前端页面生成的全流程。
环境准备
1. 基础工具
确保已安装 Cursor。如果遇到试用次数限制,可尝试重置机器码或寻找替代方案。
2. 运行环境
MCP 服务通常基于 Node.js 运行,因此需要配置好 Node.js 环境。
- Node.js: 从官网下载并配置环境变量。
- Python (可选): 若需使用 Python 相关工具,可通过
pip install uv安装。
安装完成后,使用 uv --version 或 node -v 检查版本。
配置 MCP Server
在 Cursor 中添加 MCP Server 主要有两种方式:全局配置和项目级配置。推荐在项目目录下进行配置,避免影响其他项目。
1. 全局设置
进入 Settings -> MCP -> Add new global MCP server,添加对所有项目可见的服务。
2. 项目级配置(推荐)
在项目根目录创建 .cursor 文件夹,并在其中新建 mcp.json 文件。这样配置仅对当前项目生效。
{
"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": "你的高德 API Key"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/DESKTOP/MCP"]
}
}
}
注意:
- MySQL 服务需要提前创建好对应的数据库。
- 高德地图服务需先在控制台申请 API Key。
- 文件系统路径请根据实际工作目录修改。
配置完成后,重启 Cursor 或在设置中刷新 MCP 列表,确认服务状态显示为绿色且 Enabled。
服务选择与验证
可以从 smithery.ai 或 mcp.so 等平台查找可用的 MCP Server。例如 MySQL 和高德地图服务。
验证步骤
将配置信息填入 mcp.json 后,打开 Settings -> MCP 面板。如果看到绿点标识且状态正常,说明连接成功。
实战演练:自动化出行攻略
配置就绪后,无需手动编写 HTTP 请求或 SQL 语句,直接在对话中输入自然语言需求即可。
提示词示例
现在交给你一个任务,编写一个北京一日游的出行攻略:
1. 从高德地图的 MCP 服务中获取北京站到天安门、天安门到颐和园、颐和园到南锣鼓巷的地铁线路,并保存在数据库 beijing_trip 的表 subway_trips 中;
2. 从高德地图 MCP 中获取颐和园、南锣鼓巷附近的美食信息,每处获取三家美食店铺信息,并将相应的信息存入表 location_foods 中;
3. 在工作目录 D:\DESKTOP\MCP 下创建一个新的文件夹,命名为'北京旅行',在其中创建两个 txt,分别从数据库中将两个表的内容提取出存放进去;
4. 最后根据 txt 中的内容,生成一个精美的 html 前端展示页面,并存放在该目录下。
执行效果
输入上述指令后,Cursor 会自动调度 MCP 服务:
- 数据库操作:自动连接 MySQL,执行建表 SQL 并插入数据。
- API 调用:调用高德接口获取经纬度及换乘方案。
- 文件处理:导出 TXT 并生成 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
);
最终你会得到包含交通路线和美食推荐的完整 HTML 页面,整个过程无需手写繁琐的代码逻辑。
常见问题与 Tips
- 权限问题:确保 MCP 服务拥有正确的 API Key 和数据库读写权限。
- 路径限制:文件操作通常限制在允许的工作目录内,否则可能报
Access denied。 - 数据安全:敏感信息如数据库密码建议通过环境变量管理,避免硬编码在配置文件中。
通过结合 MCP 服务和 AI 助手,我们可以将重复性的数据采集和处理工作自动化,极大提升开发效率。无论是地图数据抓取还是数据库管理,都能一站式完成。


