内容
# n8n MCP 服务器
سيرفر MCP يربط Claude مباشرةً بـ n8n — يخليك تدير الـ workflows والـ executions بالكلام بدون ما تكتب أوامر يدوية.
## ما هو MCP؟
**MCP = Model Context Protocol** — بروتوكول يخلي Claude يتحدث مع أدوات خارجية مباشرةً.
```
بدونه: أنت → تكتب curl يدوياً → n8n API → تقرأ النتيجة بعينك
معه: أنت → تقول "اشيك على الـ workflows" → Claude يتصل بـ n8n ويجيبلك النتيجة
```
## الأوامر المتاحة (أدوات)
| الأمر | الوصف |
|-------|-------|
| `list_workflows` | جيب كل الـ workflows (أو النشطة فقط) |
| `get_workflow` | جيب تفاصيل workflow معين مع كل الـ nodes |
| `create_workflow` | أنشئ workflow جديد من JSON |
| `update_workflow` | حدّث workflow موجود |
| `activate_workflow` | شغّل workflow |
| `deactivate_workflow` | أوقف workflow |
| `delete_workflow` | احذف workflow نهائياً |
| `list_executions` | جيب سجل التشغيل (فلتر بالـ ID أو الحالة) |
| `get_execution` | جيب تفاصيل execution معين مع outputs كل node |
| `delete_execution` | احذف سجل execution |
| `list_credentials` | جيب أسماء الـ credentials المحفوظة (بدون secrets) |
| `list_tags` | جيب كل الـ tags |
| `list_variables` | جيب كل متغيرات البيئة في n8n |
| `n8n_health` | تحقق إذا n8n شغال |
## التثبيت
### 1 — نزّل الملفات
```bash
git clone https://github.com/mhiggawi/n8n-mcp-server.git
cd n8n-mcp-server
```
### 2 — ثبّت المتطلبات
```bash
pip install -r requirements.txt
```
أو مباشرةً:
```bash
pip install mcp httpx
```
### 3 — جهّز الـ Claude Code settings
افتح ملف إعدادات Claude Code:
- **Mac/Linux:** `~/.claude/settings.json`
- **Windows:** `%APPDATA%\Claude\settings.json`
أضف هذا الـ block داخل `mcpServers`:
```json
{
"mcpServers": {
"n8n": {
"command": "python3",
"args": ["/full/path/to/n8n-mcp-server/server.py"],
"env": {
"N8N_BASE_URL": "https://your-n8n-url.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
```
> **ملاحظة Windows:** استخدم `python` بدل `python3` وغيّر الـ path إلى `C:\\Users\\...`
### 4 — أعد تشغيل Claude Code
أغلق وافتح Claude Code من جديد — السيرفر يشتغل تلقائياً.
## كيف تحصل على الـ API Key من n8n
1. افتح n8n → **Settings** → **API**
2. اضغط **Create API Key**
3. انسخ الـ key وحطه في `settings.json`
## مثال استخدام
بعد الإعداد، تقدر تقول لـ Claude:
```
اجيب لي كل الـ workflows النشطة في n8n
```
```
شوف آخر 5 executions اللي فيها error
```
```
شغّل الـ workflow اللي اسمه "Send Invitations"
```
```
اشيك على تفاصيل الـ execution رقم 12345
```
## المتطلبات
| المتطلب | الإصدار |
|---------|---------|
| Python | 3.10 أو أحدث |
| Claude Code CLI | أي إصدار |
| n8n | self-hosted أو cloud |
## هيكل الملفات
```
n8n-mcp-server/
├── server.py ← الـ MCP server الرئيسي
├── requirements.txt ← المكتبات المطلوبة
└── README.md ← هذا الملف
```
## ملاحظات مهمة
- الـ `N8N_API_KEY` **لا تحطه في الكود مباشرةً** — دايماً عبر `env` في `settings.json`
- الـ `list_credentials` يرجع أسماء الـ credentials فقط — **لا يكشف الـ secrets أبداً**
- الـ server يشتغل بـ `stdio` transport — أي Claude يتحدث معه عبر stdin/stdout محلياً
## مشاكل شائعة
**السيرفر ما يظهر في Claude:**
- تأكد الـ path في `args` صحيح ومطلق (full path)
- تأكد `python3` مثبت: `python3 --version`
- أعد تشغيل Claude Code بعد تعديل `settings.json`
**خطأ `401 Unauthorized`:**
- الـ API Key غلط أو منتهي — جدد من n8n Settings
**خطأ `Connection refused`:**
- الـ `N8N_BASE_URL` غلط أو n8n مش شغال
- تحقق بـ `curl https://your-n8n-url.com/healthz`
