Cursor 集成 MCP 服务实战指南
随着 AI 编程助手的普及，开发者越来越倾向于在 Cursor 等智能 IDE 中构建高效工作流。除了基础的代码补全与搜索，Cursor 通过支持 MCP（Model Context Protocol）协议，能够轻松调用高德地图 API、数据库等多种外部服务，实现数据采集、处理及自动化办公。
本文以'北京一日游自动化攻略'为例，详细讲解如何在 Cursor 中配置并使用 MCP 服务，完成从数据获取、数据库操作到文件生成和前端展示的全流程。
一、环境准备
在开始之前，我们需要确保本地开发环境满足以下要求。
1. Python 环境 (uv)
若已配置 Python 环境，推荐使用 uv 包管理器进行加速安装：
pip install uv
若未配置 Python 环境，Windows 用户可通过 PowerShell 运行以下命令快速安装：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
安装完成后，使用 uv --version 和 uvx --help 检查是否生效。
2. Node.js 环境 (npx)
前往 Node.js 官网 下载并安装，记得配置环境变量。安装后可通过 node -v 验证。
二、配置 MCP Server
在 Cursor 中添加 MCP Server 主要有两种配置方式，推荐优先使用项目级别配置。
1. 全局设置
通过 Cursor Settings → MCP → Add new global MCP server 添加，该服务对所有项目可见。
2. 项目级别（推荐）
在项目根目录创建 .cursor 文件夹，并在其中新建 mcp.json 文件。此配置仅对当前项目生效，便于隔离不同项目的依赖。
![Cursor MCP 配置界面示意图]
三、选择并接入 MCP 服务
目前社区提供了丰富的 MCP 服务器资源，我们可以根据需求选择接入。
1. MySQL 数据库
访问 Smithery 平台查找相关服务。将 JSON 配置信息复制到 mcp.json 文件中。
注意：如果直接从平台复制粘贴失败，建议找到对应的 GitHub 仓库链接，从源码中复制配置项以确保格式正确。
此外，需提前在数据库中创建好目标库（如 beijing_trip），否则连接会失败。
2. 高德地图服务
高德地图的 MCP Server 可从 MCP.so 平台获取。同时需要去 高德开放平台 申请 API Key。
3. 文件系统服务
用于读写本地文件，配置相对简单。
4. 配置文件示例
以下是一个整合了 MySQL、高德地图和文件系统的 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": "你的高德 Key"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/DESKTOP/MCP"]
}
}
}
配置完成后，打开 Settings → MCP 检查列表，确认服务状态为 Enabled 且显示绿点。
四、功能测试与实战
配置就绪后，我们可以在对话中输入自然语言指令，让 AI 自动调用这些服务。
1. 提示词设计
尝试输入如下指令：
现在交给你一个任务，编写一个北京一日游的出行攻略：
1. 从高德地图的 MCP 服务中获取北京站到天安门、天安门到颐和园、颐和园到南锣鼓巷的地铁线路，并保存在数据库 beijing_trip 的表 subway_trips 中。
2. 从高德地图的 MCP 中获取颐和园、南锣鼓巷附近的美食信息，每处获取三家美食店铺信息，并将相应的信息存入表 location_foods 中。
3. 在工作目录 D:\DESKTOP\MCP 下创建一个新的文件夹，命名为'北京旅行'，在其中创建两个 txt，分别从数据库中将两个表的内容提取出存放进去。
4. 最后根据 txt 中的内容，生成一个精美的 html 前端展示页面，并存放在该目录下。
2. 执行效果
输入后，Cursor 会自动执行以下操作：
- 连接数据库并执行建表 SQL，无需手动编写。
- 调用高德 API 接口，获取经纬度、换乘方案等数据并插入指定表。
- 操作文件系统，导出数据库内容为 txt 和 html 文件。
生成的表结构大致如下：
-- auto-generated definition
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错误。 - 数据安全：涉及敏感信息时，注意数据库账号和 API 密钥的保护，建议不要将真实密钥硬编码在公共仓库中。
通过结合 MCP 服务和 AI 助手，我们可以极大提升开发和数据处理效率。无论是地图数据采集、数据库管理，还是自动化生成前端页面，都能一站式完成。
