N8N2MCP

MCP开发工具

提供方 Super-Chain · 包名 n8n2mcp

开发工具 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

Convert N8N agent / workflow into MCP servers, you can use it in Claude / Cursor / Super Chain

一句话选型结论

按资料字段整理

N8N2MCP 属于开发工具类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 130 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

n8n2mcp mcp mcp-server n8n n8n-workflow

支持客户端

适用场景

n8n2mcpmcpmcp-server

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
git clone https://github.com/Super-Chain/N8N2MCP && cd n8n2mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
N8N2MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-04-06
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Super-Chain上游标注的维护方 Super-Chain
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时n8n2mcp · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-06上游最后核验时间

详细介绍

13.4 KB
来自项目仓库与上游目录的原文,未做删改

Transform your N8N workflows into MCP servers instantly

A comprehensive platform that converts N8N workflows into Model Context Protocol (MCP) servers, enabling seamless integration with AI assistants like Claude, Cursor, and other MCP-compatible platforms. Build powerful automation tools using N8N's visual workflow editor and deploy them as callable AI functions.

✨ How to use

  1. Copy the N8N template link/JSON from any workflow

  2. Map your credentials through our intuitive interface

  3. Deploy with one click!

Your N8N workflow gets deployed and creates a local hosted MCP server. Just paste the server URL into Claude, Cursor, Super Chain, or any MCP-compatible platform!

🎯 Key Features

🤖 MCP Server Creation

Convert your N8N workflows into MCP servers that AI assistants can use as custom tools

🔄 Dual Architecture

  • Agent Marketplace: Web-based workflow management and deployment platform
  • MCP Router: High-performance MCP server creation and routing system

🛠️ Comprehensive Workflow Management

  • Browse and deploy pre-built workflow templates
  • Upload and manage your custom N8N workflows
  • Real-time credential configuration and testing
  • One-click deployment to your N8N instance

🏗️ Architecture```mermaid

graph TB
subgraph "AI Assistant Layer"
A[Claude/Cursor/Super Chain]
end

subgraph "N8N 2 MCP"
    B[Agent Marketplace<br/>Flask Web App]
    C[MCP Router<br/>FastAPI Service]
    D[Workflow Parser<br/>Analysis Engine]
end

subgraph "Infrastructure"
    E[Supabase Database]
    F[N8N Instance]
    G[Credential Manager]
end

A -->|MCP Protocol| C
C -->|Dynamic MCP| F
B -->|Workflow Management| E
B -->|Deploy & Configure| F
C -->|User Config| E
B -->|Parse & Analyze| D
D -->|Extract Requirements| G
G -->|Secure Handling| F

## 📦 Installation

### Prerequisites
- **Python 3.11+**
- **N8N Instance** (cloud.n8n.io or self-hosted)
- **Supabase Account** (for data storage)
- **Playwright** (required for N8N authentication)
- **Docker** (optional, for containerized deployment)

> ⚠️ **Important**: Playwright installation is **required** for N8N workflow execution. The system will use dummy credentials if Playwright is not properly installed, limiting functionality.

### Quick Start

#### Option 1: Docker Compose (Recommended)

1. **Clone the repository**```bash
   git clone https://github.com/Super-Chain/N8N2MCP.git
   cd N8N2MCP
   ```

2. **Configure environment**```bash
   cp env.example .env
   # Edit .env with your actual configuration values
   ```

3. **Start with Docker Compose**```bash
   docker-compose up -d
   ```
   This starts:
   - Flask App (Agent Marketplace) at: http://localhost:5000
   - MCP Router at: http://localhost:6545

4. **View logs**```bash
   docker-compose logs -f
   ```

#### Option 2: Manual Installation

1. **Clone the repository**```bash
   git clone https://github.com/Super-Chain/N8N2MCP.git
   cd N8N2MCP
   ```

2. **Install dependencies**```bash
   pip install -r requirements.txt
    ```

3. **Install Playwright browsers** (Required)```bash
   playwright install
   # This downloads the necessary browser binaries for N8N authentication
   ```

4. **Configure environment**```bash
   # Copy and edit the .env file (see Environment Configuration section)
   cp .env.example .env
   ``````.env
    # Supabase Configuration
    SUPABASE_URL=https://your-project-id.supabase.co
    SUPABASE_KEY=your_supabase_anon_key
    SUPABASE_SERVICE_KEY=your_supabase_service_role_key

    # N8N Configuration
    X_N8N_API_KEY=your_n8n_api_key
    N8N_BASE_URL=https://your-n8n-instance.com
    N8N_USERNAME=your_n8n_username
    N8N_PASSWORD=your_n8n_password

    # MCP Router Configuration
    N8N_BUILDER_URL=http://localhost:6545

    # Server Configuration
    FLASK_HOST=0.0.0.0
    FLASK_PORT=5000
    MCP_HOST=0.0.0.0
    MCP_PORT=6545

    # Optional: Authentication credentials (auto-populated)
    N8N_AUTH=
    N8N_BROWSER_ID=
    ```

5. **Start both servers**```bash
   python main.py
   ```
   This starts:
   - Flask App (Agent Marketplace) at: http://localhost:5000
   - MCP Router at: http://localhost:6545

6. **Access to UI**
   Front end : http://localhost:5000

**Configuration Notes:**
- **SUPABASE_URL**: Your Supabase project URL
- **SUPABASE_KEY**: Anon key for client-side operations
- **SUPABASE_SERVICE_KEY**: Service role key for admin operations
- **N8N_BASE_URL**: Your N8N instance URL (must include https://)
- **N8N_BUILDER_URL**: Must include http:// protocol

## 🔧 Usage

### Creating MCP Servers from N8N Workflows

#### Method 1: Import N8N Templates
1. **Browse Templates**: Visit the N8N template
2. **Import Template**: Enter an N8N template URL from n8n.io
3. **Configure Credentials**: Fill in required API keys and service credentials
4. **Deploy Workflow**: Click deploy to create the workflow in your N8N instance
5. **MCP Server Created**: Automatically generates an MCP server endpoint

#### Method 2: Upload Custom Workflows
1. **Upload JSON**: Upload your N8N workflow JSON file / Copy and paste your JSON workflow
2. **Review Analysis**: Check detected nodes and required credentials
3. **Configure & Deploy**: Fill credentials and deploy to N8N
4. **Access MCP Server**: Use the generated MCP endpoint in AI tools

#### Using MCP Servers```bash
# Example MCP server URL format:
http://localhost:6545/mcp/{workflow_id}/{api_key}

# Test MCP server:
curl http://localhost:6545/list  # List all registered MCP servers

🎨 Use Cases

🔍 Data Processing & Analysis

  • Transform CSV/Excel files using N8N's data manipulation nodes
  • Connect to databases and APIs for real-time data analysis
  • Generate reports and visualizations from AI conversations

🌐 API Integration Hub

  • Connect AI assistants to external services (Slack, Google, etc.)
  • Create custom API endpoints for proprietary systems
  • Build unified interfaces for multiple SaaS platforms

📧 Communication & Notifications

  • Send emails, Slack messages, or Discord notifications
  • Create automated reporting systems
  • Build alert systems triggered by AI interactions

🔄 Workflow Automation

  • Trigger complex business processes from AI conversations
  • Create approval workflows and task management systems
  • Build custom integrations with enterprise systems

🛠️ Development

Project Structure```

N8N2MCP/
├── main.py # Unified server startup script
├── requirements.txt # Consolidated Python dependencies
├── .env # Environment configuration (shared)
│
├── agent_marketplace/ # Flask web application
│ ├── app.py # Main Flask app with API endpoints
│ ├── database.py # Supabase integration & data models
│ ├── n8n_workflow_parser.py # Workflow analysis engine
│ ├── setup_supabase.py # Database setup utilities
│ ├── templates/ # HTML templates
│ │ ├── workflows.html # Main marketplace interface
│ │ └── static/ # CSS, JS assets
│ └── init.py # Python package marker
│
├── mcp_router/ # FastAPI MCP service
│ ├── mcp_router.py # Main FastAPI application
│ ├── n8n_credential_extractor.py # N8N authentication
│ ├── credential_helper.py # Credential management utilities
│ └── init.py # Python package marker
│
└── README.md # This documentation


### Database Setup

The system uses **2 main tables** in Supabase:

#### Setup
1. **Create Supabase Project**: Set up a new project at supabase.com
2. **Run SQL in Supabase SQL Editor**:```sql
-- Main workflow storage table
CREATE TABLE IF NOT EXISTS public.user_workflows (
    id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
    user_id TEXT NOT NULL,
    template_id TEXT NOT NULL,
    template_url TEXT NOT NULL,
    workflow_name TEXT NOT NULL,
    workflow_json JSONB NOT NULL,
    workflow_description TEXT,
    n8n_workflow_id TEXT,
    source TEXT DEFAULT 'user_upload',
    credentials_required JSONB DEFAULT '[]'::jsonb,
    mcp_link TEXT,
    status TEXT DEFAULT 'pending',
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

-- MCP server configurations
CREATE TABLE IF NOT EXISTS public.mcp_configs (
    id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
    workflow_id TEXT NOT NULL,
    user_apikey TEXT NOT NULL,
    code TEXT NOT NULL,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    UNIQUE(workflow_id, user_apikey)
);

-- Enable Row Level Security (recommended)
ALTER TABLE user_workflows ENABLE ROW LEVEL SECURITY;
ALTER TABLE mcp_configs ENABLE ROW LEVEL SECURITY;

🚀 Running the System

Unified Startup (Recommended)```bash

python main.py

This automatically starts both services with:
- ✅ Environment validation
- ✅ Database setup verification
- ✅ Graceful shutdown handling
- ✅ Centralized logging

### Individual Services

#### Agent Marketplace (Port 5000)```bash
cd agent_marketplace
python app.py

MCP Router (Port 6545)```bash

cd mcp_router
python mcp_router.py


### Verification```bash
# Test Agent Marketplace
curl http://localhost:5000/api/health

# Test MCP Router
curl http://localhost:6545/list

# View all endpoints
curl http://localhost:5000/api/health | grep endpoints

🔧 Troubleshooting

Common Issues

Port Already in Use```bash

Kill processes on ports 5000 and 6545

fuser -k 5000/tcp 6545/tcp

Or restart with main.py which handles this automatically

python main.py


#### Database Connection Issues```bash
# Verify Supabase configuration
python -c "from agent_marketplace.database import db_manager; print('✅ Database OK' if db_manager.supabase else '❌ Database connection failed')"

# Reset database tables
python agent_marketplace/setup_supabase.py

MCP Router Not Responding```bash

Check if MCP Router is running

curl http://localhost:6545/list

View MCP Router logs

Logs appear in terminal where main.py was started


#### N8N Workflow Creation Fails
- Verify `N8N_BASE_URL` includes `https://`
- Check `X_N8N_API_KEY` is valid and has workflow creation permissions
- Ensure N8N instance is accessible from your server

#### Missing Dependencies```bash
# Install missing packages
pip install playwright
playwright install  # For N8N authentication (required)

# Or install all dependencies
pip install -r requirements.txt

Playwright Browser Issues```bash

If playwright browsers fail to download

playwright install --force

For headless environments (servers)

playwright install chromium

Check if playwright is working

python -c "from playwright.async_api import async_playwright; print('✅ Playwright OK')"


### Development Tips```bash
# Enable debug mode for Flask
export FLASK_DEBUG=1

# View detailed MCP Router logs
cd mcp_router && python mcp_router.py --log-level debug

# Test individual components
python -m agent_marketplace.n8n_workflow_parser  # Test parser
python -m mcp_router.mcp_router                  # Test MCP Router

🔐 Security Best Practices

  • Credential Management: Never store user credentials server-side
  • API Key Rotation: Regularly rotate N8N API keys and Supabase keys
  • Network Security: Use HTTPS in production with proper SSL certificates
  • Access Control: Implement proper authentication and authorization
  • Data Isolation: Ensure proper user data segregation with RLS policies

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📋 Quick Reference

API Endpoints

Agent Marketplace (Port 5000)

  • GET / - Main marketplace interface
  • GET /api/health - Health check and available endpoints
  • POST /api/import-n8n-template-enhanced - Import N8N template
  • POST /api/deploy-workflow-to-n8n - Deploy workflow with credentials
  • GET /api/user/uploaded-workflows - List user workflows
  • GET /api/user/mcp-servers - List active MCP servers

MCP Router (Port 6545)

  • GET /list - List all registered MCP servers
  • POST /n8n/build - Create MCP server from N8N workflow
  • GET /n8n/credentials/status - Check N8N credential status
  • /mcp/{workflow_id}/{api_key} - MCP server endpoint

Key File Locations

  • Configuration: .env (root directory)
  • Main Startup: main.py
  • Flask App: agent_marketplace/app.py
  • MCP Router: mcp_router/mcp_router.py

🆘 Support

  • Issues: GitHub Issues
  • Documentation: Check this README and inline code documentation
  • Community: Join our community discussions for help and feature requests

🙏 Acknowledgments

  • N8N for the amazing workflow automation platform
  • Model Context Protocol for enabling AI tool integration
  • Supabase for the robust database infrastructure
  • FastAPI and Flask for the web frameworks

Star History

Built with ❤️ by the SUPERCHAIN team for the AI automation community

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
N8N2MCP 怎么安装?

在客户端按下面的安装命令接入:git clone https://github.com/Super-Chain/N8N2MCP && cd n8n2mcp。对应的包名是 n8n2mcp。装完在客户端配置里引用同一个包或端点。

N8N2MCP 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

N8N2MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

N8N2MCP 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

N8N2MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

N8N2MCP 能提供哪些能力?

资料显示能力标签包括 n8n2mcp、mcp、mcp-server、n8n、n8n-workflow。具体工具清单以官方文档为准。

N8N2MCP 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

N8N2MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-06。