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

前言

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

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

一、什么是 MCP 服务？

MCP（Model Context Protocol）是连接 AI 模型与外部数据源的标准协议。在 Cursor 中，它允许开发者无需手动编写复杂的 HTTP 请求或繁琐配置，只需在对话中描述需求，AI 助手即可自动调用相关服务（如地图查询、数据库读写），极大提升开发效率。

二、环境准备

2.1 基础工具

确保已安装 Cursor 编辑器。如果提示机器码限制，请检查本地环境配置。

2.2 Python - uv

若已配置 Python 环境，可使用以下命令安装：

pip install uv

若未配置 Python 环境，Windows 下可通过 PowerShell 运行：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装完成后，使用 uv --version 和 uvx --help 验证。

2.3 Node.js - npx

下载并安装 Node.js，配置环境变量后，确保终端可执行 node 和 npm 命令。MCP Server 通常通过 npx 启动。

三、在 Cursor 中添加 MCP Server

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

3.1 全局设置

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

3.2 项目级别（推荐）

在项目目录的 .cursor 文件夹中新建 mcp.json 文件进行配置，仅对当前项目生效。这种方式更利于版本管理和权限隔离。

四、选择与配置 MCP Server

4.1 MySQL 服务

访问 Smithery 获取 MySQL MCP Server 的配置信息。将 JSON 内容复制到 mcp.json 文件中。

注意：粘贴时建议直接从 GitHub 仓库获取原始配置，避免格式错误。此外，需提前创建好对应的数据库。

4.2 高德地图服务

高德地图的 MCP Server 可从 MCP.so 平台获取。同时需要在 高德开放平台 申请 API Key。

4.3 文件系统服务

系统内置或第三方提供的文件系统服务，用于读写本地文件。

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 编写提示词

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

现在交给你一个任务，编写一个北京一日游的出行攻略：

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
);

最终会生成包含数据的 HTML 页面，直观展示行程规划。

六、实用 Tips

1. 权限配置：确保 MCP 服务已正确配置 API Key 和数据库权限，否则无法连接。
2. 目录路径：文件操作需在允许的工作目录下进行，否则会报 Access denied 错误。
3. 数据安全：涉及敏感信息（如数据库密码、API Key）时，建议使用环境变量管理，避免硬编码在配置文件中。

结语

在 Cursor 中结合 MCP 服务和 AI 助手，可以极大提升开发和数据处理效率。无论是地图数据采集、数据库管理，还是自动化生成前端页面，都能一站式完成。掌握这一工作流，能让 AI 真正成为你的开发副手。