MCP N8n Webhook

🚀 MCP N8N Webhook 服務器

MCP（模型上下文協議）服務器，用於將數據發送到 n8n 的 Webhook 進行存儲和索引。它可以幫助 AI 助手通過 Webhook 將結構化信息保存到 n8n 中，適用於保存對話和開發日誌、存儲項目文檔、索引信息以便後續搜索以及為 RAG 創建內容嵌入等場景。

🚀 快速開始

MCP 服務器允許 AI 助手通過 Webhook 將結構化信息保存到 n8n 中。它適用於以下場景：

• 保存對話和開發日誌
• 存儲項目文檔
• 索引信息以便後續搜索
• 為 RAG 創建內容嵌入

✨ 主要特性

• 支持 AI 助手將結構化信息保存到 n8n。
• 適用於多種數據存儲和索引場景。

📦 安裝指南

npm install
npm run build

📚 詳細文檔

配置

創建一個基於 config.example.env 的 .env 文件：

cp config.example.env .env

配置環境變量：

• N8N_WEBHOOK_URL：n8n Webhook 的基礎 URL
• N8N_WEBHOOK_ID：Webhook 的唯一 ID
• N8N_API_KEY：用於身份驗證的 API 密鑰
• N8N_INDEX_NAME：默認索引名稱（可選，默認值：PROJECT_CONVERSATIONS）
• N8N_TABLE_CATEGORY：默認表類別（可選，默認值：DEVELOPMENT_LOGS）

使用

開發模式

npm run dev

檢查模式（用於測試）

npm run inspector

生產模式

npm start

可用工具

n8n_save_data

將結構化信息保存到 n8n 的 Webhook 中。

參數：

• projectName（必需）：項目名稱
• projectCategory（必需）：項目類別
• contentType（必需）：內容類型
• title（必需）：內容標題
• description（必需）：內容描述
• text（必需）：完整文本
• tags（必需）：標籤數組
• projectId（可選）：項目 ID
• projectStatus（可選）：項目狀態
• language（可選）：內容語言
• indexName（可選）：索引名稱
• tableCategory（可選）：表類別
• source（可選）：數據來源

n8n_health_check

驗證與 n8n Webhook 的連接性。

有效負載結構

服務器以以下格式發送數據：

{
  "metadata": {
    "timestamp": "2025-07-02T10:30:00Z",
    "source": "mcp_assistant",
    "version": "1.0"
  },
  "project": {
    "id": "proj_001",
    "name": "Sistema de Embeddings",
    "category": "AI_ML",
    "status": "ACTIVE"
  },
  "content": {
    "type": "CONVERSATION",
    "title": "Implementación de almacenamiento vectorial",
    "description": "Discusión sobre la arquitectura...",
    "text": "Se está implementando un sistema...",
    "tags": ["embeddings", "vectorial", "conversaciones"],
    "language": "es"
  },
  "indexing": {
    "index_name": "PROJECT_CONVERSATIONS",
    "table_category": "DEVELOPMENT_LOGS"
  }
}

📄 許可證

MIT