使用说明
n8n工作流MCP服务器
| | | | |
🎬 演示视频
观看演示工作流搜索功能的视频：
n8n用于验证和管理工作流的模型上下文协议（MCP）服务器。
🚀 主要功能
🌍 多语言支持
- 韩语（ko） -默认语言
- 英语（en） -英语支持
- 日语（jp） -日语支持
- 越南语（vn） -支持越南语
- 台语（tw） -繁体中文支持
- 泰语（th） -泰语支持
- 所有工具提示和参数提示均以所选语言显示
📝 工作流管理工具
- 拼 -检查服务器连接状态
- validate_workflow 验证JSON文件的n8n工作流语法
🔍 搜索工具
- search_n8n_nodes -使用关键字搜索n8n节点
- 搜索工作流-搜索社区n8n工作流模板
🛠 安装和构建
必要条件
- Go 1.23或更高版本
构建方法
🚀 单机模式（推荐）
在构建时，所有n8n节点数据都可以在二进制中运行，无需外部文件：
# 현재 플랫폼용 standalone 빌드
make build-standalone
# 또는
make build
# Linux 64bit standalone 빌드
make build-standalone-linux
# 또는
make build-linux
# Windows 64bit standalone 빌드
make build-standalone-windows
# 또는
make build-windows
特定平台的构建
macOS（英特尔）：
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o build/n8n-mcp-server-darwin ./cmd/n8n-mcp-server
macOS（苹果硅M1/M2）：
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o build/n8n-mcp-server-darwin-arm64 ./cmd/n8n-mcp-server
🎯 执行方法
🚀 单机模式（推荐）
无需外部文件，仅二进制运行（默认模式）：
# macOS/Linux
./build/n8n-mcp-server -standalone
# Windows
build\n8n-mcp-server.exe -standalone
# Makefile 사용
make run
# 또는
make run-standalone
📁 文件系统模式（用于开发）
使用外部数据文件：
# macOS/Linux
./build/n8n-mcp-server -standalone=false
# Windows
build\n8n-mcp-server.exe -standalone=false
直接运行Go命令
# Standalone 모드 (기본)
go run ./cmd/n8n-mcp-server -standalone
# 파일 시스템 모드
go run ./cmd/n8n-mcp-server -standalone=false
🌐 多语言支持
服务器支持韩语（ko）、英语（en）、日语（jp）、越南语（vn）、台语（tw）和泰语（th）。 --lang 可以将语言设置为标志：
# Standalone 모드
./build/n8n-mcp-server -standalone --lang ko # 한국어 (기본값)
./build/n8n-mcp-server -standalone --lang en # 영어
./build/n8n-mcp-server -standalone --lang jp # 일본어
./build/n8n-mcp-server -standalone --lang vn # 베트남어
./build/n8n-mcp-server -standalone --lang tw # 대만어
./build/n8n-mcp-server -standalone --lang th # 태국어
# 파일 시스템 모드
./build/n8n-mcp-server -standalone=false --lang ko # 한국어 (기본값)
./build/n8n-mcp-server -standalone=false --lang en # 영어
./build/n8n-mcp-server -standalone=false --lang jp # 일본어
./build/n8n-mcp-server -standalone=false --lang vn # 베트남어
./build/n8n-mcp-server -standalone=false --lang tw # 대만어
./build/n8n-mcp-server -standalone=false --lang th # 태국어
调整搜索权重
您可以在节点搜索时调整每个元素的权重：
# Standalone 모드에서 검색 가중치 조정
./build/n8n-mcp-server -standalone \
--name-weight 3.0 \
--overview-weight 2.0 \
--case-weight 1.5 \
--op-weight 1.0
# 파일 시스템 모드에서 검색 가중치 조정 및 데이터 경로 변경
./build/n8n-mcp-server -standalone=false \
--name-weight 3.0 \
--overview-weight 2.0 \
--case-weight 1.5 \
--op-weight 1.0 \
--data-path /custom/path/to/nodes
🆘 其他选项
# 도움말 보기
./build/n8n-mcp-server --help
# 버전 확인
./build/n8n-mcp-server --version
🔧 Claude Code&Cursor设置
macOS设置
设置文件位置： ~/Library/Application Support/Claude/claude_desktop_config.json
Standalone模式（推荐）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "/Users/{username}/{clone_path}/build/n8n-mcp-server",
"args": ["--standalone", "--lang", "ko"]
}
}
}
文件系统模式（用于开发）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "/Users/{username}/{clone_path}/build/n8n-mcp-server",
"args": ["-standalone=false", "--lang", "ko"]
}
}
}
Go运行模式（用于开发）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "go",
"args": ["run", "./cmd/n8n-mcp-server", "--standalone", "--lang", "ko"],
"cwd": "/Users/{username}/{clone_path}"
}
}
}
Windows设置
设置文件位置： %APPDATA%\Claude\claude_desktop_config.json
Standalone模式（推荐）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe",
"args": ["--standalone", "--lang", "ko"]
}
}
}
文件系统模式（用于开发）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe",
"args": ["-standalone=false", "--lang", "ko"]
}
}
}
Go运行模式（用于开发）：
{
"mcpServers": {
"n8n-kor-workflow": {
"command": "go",
"args": ["run", ".\\cmd\\n8n-mcp-server", "--standalone", "--lang", "ko"],
"cwd": "C:\\path\\to\\n8n-workflow-mcp"
}
}
}
📁 项目结构
n8n-workflow-mcp/
├── cmd/
│ └── n8n-mcp-server/ # 메인 애플리케이션 엔트리포인트
├── internal/
│ ├── config/ # 설정 관리
│ ├── handlers/ # MCP 요청 핸들러
│ ├── i18n/ # 다국어 지원
│ ├── search/ # 검색 엔진
│ ├── server/ # MCP 서버 구현
│ ├── services/ # 비즈니스 로직
│ ├── store/ # 데이터 저장소
│ ├── validator/ # 워크플로우 검증
│ └── workflow/ # 워크플로우 관리
├── pkg/
│ └── types/ # 공통 타입 정의
├── examples/
│ └── config/ # Claude Code & Cursor 설정 예제
├── test/ # 테스트 파일
└── build/ # 빌드 결과물
🧪 测试
# 모든 테스트 실행
make test
# 커버리지와 함께 테스트 실행
make test-coverage
🛠 开发
# 코드 포맷팅
make fmt
# 린팅
make lint
# 모듈 정리
make mod-tidy
# 빌드 파일 정리
make clean
📊 模式比较
| 功能 | 单机模式 | 文件系统模式 |
|---|---|---|
| 易于部署 | 需要单一二进制文件附加文件 | |
| 运行速度 | 快 | 快 |
| 内存使用量 | 高一点 | 低一点 |
| 易于开发 | 需要重新构建 | 实时反映 |
| 生产环境 | 宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传宣传 | |
| 开发环境 | 可以使用 | 宣传 |
