Vapi MCP

🚀 Vapi MCP 用於 Cursor 的實現

本項目達成了將 Vapi 的語音 AI 功能與 Cursor 集成的 Model Context Protocol (MCP) 服務器，實現了兩者之間的數據交互。

✨ 主要特性

• 實現 Vapi 語音 AI 功能與 Cursor 的集成。
• 提供 MCP 服務器，用於監聽和處理請求。

📦 安裝指南

環境配置

在 vapi-mcp-server 目錄下創建一個 .env 文件，包含以下變量：

# Vapi API 密鑰
VAPI_ORG_ID=your-org-id
VAPI_PRIVATE_KEY=your-private-key
VAPI_KNOWLEDGE_ID=your-knowledge-id
VAPI_JWT_PRIVATE=your-jwt-private

# 環境配置
NODE_ENV=development

服務器構建

要構建服務器，執行以下命令：

cd vapi-mcp/vapi-mcp-server
npm install
npm run build

💻 使用示例

基礎用法

在 Cursor 中配置 Vapi MCP 服務器，以下是正確的 .cursor/mcp.json 配置示例：

"Vapi Voice AI Tools": {
  "command": "node",
  "type": "stdio",
  "args": [
    "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server/dist/index.js"
  ],
  "cwd": "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server",
  "env": {
    "VAPI_ORG_ID": "your-org-id",
    "VAPI_PRIVATE_KEY": "your-private-key",
    "VAPI_KNOWLEDGE_ID": "your-knowledge-id",
    "VAPI_JWT_PRIVATE": "your-jwt-private",
    "NODE_ENV": "development"
  }
}

📚 詳細文檔

項目結構

Vapi MCP 服務器的結構如下：

• vapi-mcp-server/ - 主服務器代碼
  • src/ - TypeScript 源文件
  • dist/ - 編譯後的 JavaScript 輸出
  • .env - 環境變量文件（用於 API 密鑰）

在 Cursor 中的配置

注意：避免“客戶端已關閉”錯誤

在 Cursor 的 MCP 設置中配置 Vapi MCP 服務器時，請注意以下重要事項：

1. 工作目錄：cwd 參數是必需的，以確保服務器在正確的目錄下運行，並能夠正確訪問 .env 文件。
2. 環境變量：即使存在 .env 文件，也必須顯式地將環境變量提供到配置中。
3. 模塊類型：由於服務器使用 ES 模塊，因此 package.json 中必須包含 "type": "module"。

故障排除

“客戶端已關閉”錯誤在 Cursor 中

如果在 Cursor 的 MCP 工具面板中看到“客戶端已關閉”，可按以下步驟排查：

1. 檢查工作目錄：確保 cwd 參數在您的 mcp.json 中設置正確。
2. 驗證環境變量：確認所有必需的環境變量都已通過配置傳遞。
3. 檢查模塊類型：確保 package.json 包含 "type": "module"。
4. 檢查權限：確保 dist/index.js 文件具有可執行權限（使用 chmod +x dist/index.js）。
5. 直接測試服務器：嘗試手動運行服務器以檢查錯誤：

cd vapi-mcp/vapi-mcp-server
node --trace-warnings dist/index.js

模塊未找到錯誤

如果出現“錯誤：找不到模塊”，可按以下步驟處理：

1. 檢查工作目錄：您是否在正確的目錄下運行？
2. 重新構建：嘗試通過 npm run build 重建項目。
3. 依賴項：確保所有依賴項已安裝（使用 npm install）。

可用工具

Vapi MCP 服務器提供的工具包括：

• vapi-mcp-server/src/index.ts - 主服務器文件，用於監聽和處理請求。
• vapi-mcp-server/dist/index.js - 編譯後的主執行文件。

📄 注意事項

⚠️ 重要提示

1. 確保所有環境變量都已正確設置，並且 .env 文件位於項目根目錄下。
2. 在生產環境中使用之前，請確保服務器已經過充分測試，並配置了適當的錯誤處理和日誌記錄機制。
3. 如果遇到任何問題或有進一步的疑問，請參考 Vapi 的官方文檔或聯繫支持團隊。

通過以上步驟，您可以成功將 Vapi 的語音 AI 功能與 Cursor 集成，並利用 MCP 協議進行數據交互。