Cursor 中配置与使用 MCP 服务实战指南

前言

随着 AI 编程助手的普及，开发者倾向于在 Cursor 等智能 IDE 中进行高效开发。除了代码补全和搜索，Cursor 还支持通过 MCP（Model Context Protocol）服务调用外部 API，如高德地图、数据库等，实现数据采集、处理和自动化办公。

本文以'北京一日游自动化攻略'为例，详细讲解如何在 Cursor 中集成 MCP 服务，完成从数据采集到前端页面展示的全流程。

一、什么是 MCP 服务？

MCP（Model Context Protocol）是 Cursor 内置的多工具接口协议，支持连接地图、数据库、文件系统等资源。通过它，开发者无需手动编写 HTTP 请求或繁琐配置，只需在对话中描述需求，AI 助手即可自动调用相关服务，极大提升开发效率。

二、环境准备

2.1 Python 环境

若已配置 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.2 Node.js 环境

前往 Node.js 官网 下载并配置环境变量。

三、在 Cursor 中添加 MCP Server

在 Cursor 中添加 MCP Server 有两种配置方式：

3.1 全局设置

通过 Cursor Settings -> MCP -> Add new global MCP server 添加全局可用的服务。

3.2 项目级别（推荐）

在项目目录的 .cursor 文件夹中新建 mcp.json 文件进行配置，仅对特定项目生效。

四、选择 MCP Server 平台

4.1 MySQL

参考官方文档或社区资源获取配置信息，将 JSON 内容复制到 mcp.json 文件中。

注意：MySQL MCP 服务需要提前创建好数据库，否则无法连接。

4.2 高德地图服务

高德地图的 MCP Server 需从相关平台获取。申请高德地图 API Key 后，将其填入配置。

4.3 文件系统服务

配置本地文件访问权限，确保 MCP 能读写指定目录。

4.4 配置参考

以下是一个包含 MySQL、高德地图和文件系统的完整配置示例：

{
  "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 且有绿点显示。

五、功能测试

5.1 提示词示例

在对话框中输入自然语言指令，例如：

现在交给你一个任务，编写一个北京一日游的出行攻略：
1. 从高德地图的 MCP 服务中获取北京站到天安门、天安门到颐和园、颐和园到南锣鼓巷的地铁线路，并保存在数据库 beijing_trip 的表 subway_trips 中；
2. 从高德地图 MCP 中获取颐和园、南锣鼓巷附近的美食信息，每处获取三家店铺信息，存入表 location_foods 中；
3. 在工作目录 D:\DESKTOP\MCP 下创建新文件夹'北京旅行'，在其中创建两个 txt，分别从数据库中提取两个表的内容存放进去；
4. 最后根据 txt 中的内容，生成一个精美的 HTML 前端展示页面，并存放在该目录下。

5.2 执行效果

输入提示词后，Cursor 会自动调用 MCP 服务：

1. 连接数据库并执行建表 SQL，无需手动写代码；
2. 调用高德 API 获取经纬度、地铁换乘方案等数据，插入指定表；
3. 操作文件系统，导出数据库内容为 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
);

六、实用 Tips

1. 权限配置：确保 MCP 服务已正确配置 API Key 和数据库权限。
2. 目录路径：文件操作需在允许的工作目录下进行，否则会报 Access denied。
3. 数据安全：涉及敏感信息时，注意数据库和 API 密钥的保护，避免硬编码在公开仓库中。