Cursor最佳实践之三：MCP

一、概述

MCP为模型提供了与外部系统和资源交互的能力，是AI模型与现实世界沟通的桥梁。MCP赋予模型环境感知、工具使用、持久化操作、实时交互等能力，允许模型：

调用外部API和服务
访问与操作文件系统
执行代码并获取结果
控制外部工具和应用程序
获取实时数据与信息

二、在Cursor中添加 MCP server

通过 Cursor Settings -> MCP ->Installed MCP servers 添加 MCP 服务:

点击添加按钮，弹出mcp配置：

三、使用MCP服务

机器上检查目录：

四、MCP 配置文件结构

基本结构

复制代码

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR": "value"
      },
      "timeout": 30000,
      "alwaysAllow": ["tool1", "tool2"]
    }
  }
}

配置项说明

mcpServers（根配置项）

用途: 定义所有 MCP 服务器的配置对象

类型: Object

说明: 包含多个 MCP 服务器的配置，每个服务器有一个唯一名称作为 key
2.

server-name（服务器名称）

用途: 定义 MCP 服务器的唯一标识名称类型: String（作为 Object 的 key）
说明:

可以是任意字符串
建议使用有意义的名称，如 file-system、database、git 等
这个名称会在 Cursor 中显示

command（命令）

用途: 指定启动 MCP 服务器的命令类型: String说明:

可以是系统命令（如 node、python、npx）
可以是可执行文件的路径
必须能在系统 PATH 中找到

常见值:

"npx": 使用 npx 运行 npm 包
"node": 使用 Node.js 运行脚本
"python": 使用 Python 运行脚本
"/path/to/executable": 直接指定可执行文件路径

args（参数）

用途: 传递给 command 的参数数组类型: Array of Strings说明:

数组中的每个元素都是命令的参数
按顺序传递给命令
通常第一个参数是 MCP 服务器包名或脚本路径
后续参数是服务器特定的配置参数

常见参数:

"-y": npx 的参数，表示自动确认安装
"@modelcontextprotocol/server-xxx": MCP 服务器包名
"/path/to/config": 配置文件路径
"--port", "8080": 服务器端口配置

env（环境变量）

用途: 设置 MCP 服务器的环境变量类型: Object说明:

键值对形式
在服务器启动时注入环境变量
常用于配置 API 密钥、数据库连接等敏感信息

常见用途:

API 密钥配置
数据库连接信息
服务器端口配置
日志级别配置

timeout（超时时间）

用途: 设置服务器响应的超时时间（毫秒）

类型: Number

单位: 毫秒（ms）

默认值: 通常为 30000（30秒）
说明:

如果服务器在指定时间内没有响应，请求会超时
对于长时间运行的任务，可以设置更大的值

alwaysAllow（始终允许的工具）

用途: 定义始终允许执行的工具列表，无需用户确认

类型: Array of Strings
说明:

列出工具名称数组
这些工具在执行时不需要用户确认
用于信任的工具，提升使用体验

总结

必需配置项:

mcpServers: 根配置对象
server-name: 服务器名称（作为 key）
command: 启动命令
args: 命令参数（通常需要）

可选配置项:

env: 环境变量
timeout: 超时时间
alwaysAllow: 自动允许的工具列表