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 提取設計規格、檢索發票資料或直接從聊天介面執行工作流程管線。