N8n MCP Server Complete

🚀 n8n MCP 服務器

n8n MCP 服務器是基於模型上下文協議（MCP）構建的，它能讓大語言模型（LLM）和 AI 代理無縫管理 n8n 工作流，極大提升工作流管理的便捷性與效率。

✨ 主要特性

• 可列出 n8n 的可用工作流，方便用戶快速瞭解可使用的工作流資源。
• 支持查看工作流詳細信息，便於深入掌握工作流的具體內容。
• 能夠執行工作流，實現業務流程的自動化操作。
• 可監控工作流執行情況，及時掌握工作流的運行狀態。
• 可以傳遞參數到工作流，滿足不同場景下的個性化需求。
• 具備與 AI 代理兼容的 MCP 接口，增強了系統的擴展性和兼容性。

🚀 快速開始

安裝與配置

1. 安裝包

   npm install @dopehunter/n8n-mcp-server
   

2. 創建 .env 文件

   cp .env.example .env
   

3. 配置您的 n8n 連接 編輯 .env 文件並設置：

   • N8N_BASE_URL：您的 n8n 實例 URL（例如，http://localhost:5678/api）
   • N8N_API_KEY：您的 n8n API 密鑰（在 n8n 設置中生成）

4. 啟動服務器

   npm start
   

5. 測試服務器

   curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'
   

常見問題和故障排除

• 連接被拒絕錯誤：請確保您的 n8n 實例正在運行並且可以通過指定的 URL 訪問。
• API 密鑰問題：請檢查密鑰是否正確配置。
• 端點不可用：請確保服務器已成功啟動並在監聽 3000 端口。

📦 安裝指南

開發環境

• 啟動開發服務器：

  npm run start:dev
  

• 構建項目：

  npm run build
  

• 運行測試：

  npm test
  

Docker 鏡像構建

docker build -t mcp/n8n-mcp-server .

💻 使用示例

與Claude或其他 LLM 的配合

1. 啟動 MCP 服務器：

   npm start
   

2. 配置您的 LLM 客戶端以使用 MCP 服務器：
   • 對於 Claude Desktop，請參考“配置選項”部分。
   • 對於其他客戶端，請指向服務器 URL（例如，http://localhost:3000/mcp）。
3. 您的 LLM 現在可以通過 MCP 命令直接使用 n8n 工作流了。

📚 詳細文檔

有關可用的 MCP 函數詳細信息，請參閱 API 文檔。

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。

📄 許可證

本項目根據 ISC 許可證發佈。