mcp-server

此技能为开发人员提供了一个完整的框架，用于通过建立与设定自定义模型上下文协议 (MCP) 服务器来扩展 Cursor IDE 的功能。它专为需要将内部工具、本地数据库或外部 API 直接整合到其 IDE 工作流程中的工程师与 AI 辅助开发人员所设计，让 AI 能以更高的自主性与精确度与资料互动并执行操作。

• 支持在 ~/.cursor/projects 目录中建立标准化的 MCP 服务器文件夹结构。

• 支持多种验证模式，包括透过环境变量注入 API 金钥匙、基于本地 URL 的连线以及 OAuth 验证工作流程。

• 提供系统化的 JSON 工具描述定义方法，包含自定义名称、说明、参数架构与必要字段。

• 促进将外部服务（如 Notion、n8n、Figma 及自定义文件查询工具）整合至 AI 的上下文感知工具库中。

• 包含针对安装循环、配置错误及 Cursor IDE 内服务器注册问题的专用排错流程。

• 使用者应精确定义工具架构，以确保透过 CallMcpTool 函数进行有效的参数解析与执行。

• 确保在 ~/.cursor/mcp.json 设置档中正确映射服务器指令、引数与环境变量。

• 修改 MCP 设置后，务必执行窗口重新加载 (Cmd+Shift+P > Reload Window)，以确保 IDE 成功注册变更。

• 透过安全的环境区块管理 API 金钥匙，而非将凭证直接硬编码于 JSON 描述档中，借此优先确保安全性。

• 在将新工具部署至关键开发工作流程之前，请务必先使用 CallMcpTool 指令进行测试。

• 适用于自动化跨工具操作，例如从 Figma 提取设计规格、检索发票数据或直接从聊天接口执行工作流程管线。