Th技术开发白皮书

Cursor-MCP Service 使用说明

2025/3/29 工具Cursor

# Cursor-MCP Service 使用说明

# 一、cursor-MCP 服务介绍

Model Context Protocol（MCP，模型上下文协议）是 Anthropic 公司推出的开放标准协议，旨在为 AI 工具（如 Cursor IDE）与应用程序之间提供安全的双向交互接口，类似于传统应用中的 HTTP 协议。通过 MCP 服务，用户可扩展 Cursor 的功能，例如文件操作、网页内容解析、代码分析等，提升 AI 开发效率。

# 二、使用说明与配置步骤

# 1. 环境准备

  • 安装 Node.js 和 npm： 确保系统中已安装 Node.js（通过 node -v 和 npm -v 验证版本）。 macOS 用户可使用 brew install node，Windows 用户需手动安装。

  • 全局依赖管理（可选）： 多数 MCP 服务需通过 npm 安装（如 npm install -g @modelcontextprotocol/server-filesystem），但建议使用本地配置或 npx 以避免全局依赖冲突。

# 2. 配置 MCP 服务器（以 mysql-mcp-server/ApiIFox文档 为例）
  1. 安装mysql-mcp-server： 搜索MCP公开库：https://smithery.ai/ 并找到官方mysql-mcp

777

888

999

  1. 安装ApiIFox文档：
    • npx会安装失败，亲测，所以需要手动配置mcp。
    • 手动放到MCP.json文件中宏，注意项目ID和token的替换。
           {
       "API 文档": {
           "command": "npx",
           "args": [
               "-y",
               "apifox-mcp-server@latest",
               "--project=<project-id>"
           ],
           "env": {
               "APIFOX_ACCESS_TOKEN": "<access-token>"
           }
       }
   }

000

  • 保存后按钮变绿即表示成功。

# 二、实战示例

# 示例 1：mysql-mcp-server

  • 通过对话可以链接和查询和修改到数据库相关信息，注意：不要随意操作或者通过对话修改和删除 表或表结构 例如：

    image-20250328下午60048820

# 示例 2：API文档

​ - 通过对话可以链接和查询ApiFox中接口，前端可以借助这个工具实现业务的快速渲染 例如：

image-20250328下午60413842

# 三、总结

  1. 优势：

    • 灵活性：通过配置文件支持多种服务，扩展性强。
    • 安全性：通过目录限制和参数验证保证操作安全。
    • 跨模型支持：适配不同 LLM Agent，提升工具复用性。
    • 强大的MCP库：再开发当中可以使用多个组件库，来调用MCP实现对应的效果。

  2. 最佳实践：

    • 优先使用本地或 npx 安装服务，减少全局依赖冲突。
    • 根据不同的MCP来协助开发协同增效。
    • 参考社区资源（如 smithery.ai）获取预构建服务器模板。

参考文档：