MCP N8n Webhook

🚀 MCP N8N Webhook Server

MCP（Model Context Protocol）サーバーで、n8nのWebhookにデータを送信し、保存およびインデックス化します。

🚀 クイックスタート

このMCPサーバーは、AIアシスタントがWebhookを介して構造化された情報をn8nに保存できるようにします。以下の用途に最適です。

• 会話と開発ログの保存
• プロジェクトのドキュメントの保存
• 後の検索のための情報のインデックス化
• RAGのためのコンテンツの埋め込み作成

📦 インストール

npm install
npm run build

📚 ドキュメント

設定

.envファイルをconfig.example.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