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