几个好用的MCP分享

MCP配置让AI工具获外部能力

原创已于 2025-07-20 00:24:32 修改 · 1.3k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#MCP #cursor

于 2025-07-19 15:23:07 首次发布

工具使用专栏收录该内容

10 篇文章

订阅专栏

下面是一个详细的 MCP（Model Context Protocol）服务器配置教程，适用于 Cursor、Claude Code 等支持 mcp.json（或类似 JSON 配置文件）格式的 AI 工具。内容涵盖原理、常用配置项、环境变量写法、常见用法和注意事项，并结合实际的配置举例说明。

MCP 配置教程（以 Cursor/Claude Code 为例）

1. MCP 原理简介

MCP（Model Context Protocol）是一种用于 AI 工具与外部服务（如数据库、API、浏览器自动化等）集成的协议。通过配置 mcp.json（或 .cursor/mcp.json），你可以让 AI 具备“调用外部工具”的能力，实现代码自动化、数据查询、网页操作等高级功能。

2. mcp.json 文件结构

mcp.json 是一个标准的 JSON 文件，通常位于用户主目录下的 .cursor 或 .claude 文件夹中。其核心结构如下：

{
  "mcpServers": {
    "服务别名": {
      "command": "启动命令",
      "args": ["参数1", "参数2", ...],
      "env": { "环境变量名": "值", ... },
      "enabled": true
    },
    ...
  }
}

服务别名：自定义，AI 工具通过别名调用该服务
command：要执行的命令（如 npx、python、cmd.exe 等）
args：命令行参数数组
env：环境变量（可选，常用于数据库/API 密钥等）
enabled：是否启用（可选，true/false）

3. 常见服务配置举例

3.1 MySQL 数据库 MCP

"mysql": {
  "command": "npx",
  "args": [
    "-y",
    "@benborla29/mcp-server-mysql"
  ],
  "env": {
    "MYSQL_HOST": "192.168.100.151",
    "MYSQL_PORT": "3003",
    "MYSQL_USER": "root",
    "MYSQL_PASS": "123456",
    "MYSQL_DB": "ry-vue",
    "ALLOW_INSERT_OPERATION": "true",
    "ALLOW_UPDATE_OPERATION": "true",
    "ALLOW_DELETE_OPERATION": "true"
  }
}

说明：通过 npx 启动 MySQL MCP 服务，env 里配置数据库连接参数和权限。

3.2 Postgres 数据库 MCP

"postgres": {
  "command": "C:\\Windows\\System32\\cmd.exe",
  "args": [
    "/c",
    "npx",
    "-y",
    "@modelcontextprotocol/server-postgres",
    "postgresql://postgres:123456@localhost:5432/bladex"
  ]
}

说明：通过 npx 启动 Postgres MCP 服务，连接字符串直接写在 args 里。

3.3 浏览器自动化（Playwright）

"playwright": {
  "command": "npx",
  "args": ["-y", "@executeautomation/playwright-mcp-server"]
}

说明：用于网页自动化、页面抓取等。

3.4 Supabase（云）

"supabase": {
  "command": "C:\\Windows\\System32\\cmd.exe",
  "args": [
    "/c",
    "npx",
    "-y",
    "@supabase/mcp-server-supabase@latest",
    "--access-token",
    "你的supabase token"
  ]
}

3.5 其它服务（如 Brave Search、上下文服务等）

"brave-search": {
  "command": "C:\\Windows\\System32\\cmd.exe",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@smithery-ai/brave-search",
    "--config",
    "{\"braveApiKey\":\"123321\"}"
  ]
}

4. 环境变量写法

Windows 下推荐用 "env": { ... }，如上 mysql 示例
Linux/Mac 下也可用 "env": { ... }
不要在 args 里直接写 export/set，统一用 env 字段

5. 启用/禁用服务

"enabled": true 表示启用，省略则默认启用
设置为 false 可临时关闭某个服务

6. 常见问题与注意事项

路径区分大小写，Windows 下注意转义和绝对路径
npx 需已全局安装 Node.js
某些服务需要 API Key 或 Token，务必妥善保管
修改 mcp.json 后，建议重启 AI 工具以生效
某些服务（如数据库）需保证网络可达

7. 进阶：自定义服务

你可以集成任何支持命令行启动的服务，只需配置 command、args、env 即可。例如自定义 Python 脚本、Shell 工具等。

8. 参考你的实际配置（节选）

"mysql": {
  "command": "npx",
  "args": [
    "-y",
    "@benborla29/mcp-server-mysql"
  ],
  "env": {
    "MYSQL_HOST": "192.168.100.151",
    "MYSQL_PORT": "3003",
    "MYSQL_USER": "root",
    "MYSQL_PASS": "123456",
    "MYSQL_DB": "ry-vue",
    "ALLOW_INSERT_OPERATION": "true",
    "ALLOW_UPDATE_OPERATION": "true",
    "ALLOW_DELETE_OPERATION": "true",
    "ALLOW_ALTER_OPERATION": "true",
    "ALLOW_DROP_OPERATION": "true"
  }
}