Skip to main content
Glama
amirbiron

CodeBot MCP Server v2

by amirbiron
README.md
# šŸ¤– CodeBot MCP Server v2

שרת MCP ×ž×•×Ø×—×‘ לניהול קוד, דפלוי ×•×Ŗ×¤×¢×•×œ — ×ž×•×Ŗ×× ×œ×—×™×‘×•×Ø ל-Claude.

---

## ✨ ×™×›×•×œ×•×Ŗ

### šŸ“ ניהול Snippets
| כלי | תיאור |
|------|--------|
| `list_snippets` | ×Ø×©×™×ž×” עם הינון לפי שפה / ×Ŗ×’×™×Ŗ / חיפוש |
| `get_snippet` | ×§×‘×œ×Ŗ snippet בודד |
| `create_snippet` | יצירת snippet חדש |
| `update_snippet` | עדכון snippet קיים |
| `delete_snippet` | ×ž×—×™×§×Ŗ snippet |
| `search_by_code` | חיפוש regex ×‘×Ŗ×•×š הקוד |
| `get_stats` | ×”×˜×˜×™×”×˜×™×§×•×Ŗ על ×”×ž××’×Ø |

### šŸ” ניתוח קוד
| כלי | תיאור |
|------|--------|
| `analyze_snippet` | ניתוח ×ž×˜×Ø×™×§×•×Ŗ, דפוהים ×‘×¢×™×™×Ŗ×™×™× והצעות |
| `bulk_tag_snippets` | עדכון תגיות על ×ž×”×¤×Ø snippets בבת אחת |

### šŸš€ Render API (×Ŗ×¤×¢×•×œ)
| כלי | תיאור |
|------|--------|
| `render_service_status` | מצב השירות הנוכחי |
| `render_list_deploys` | דפלויים ××—×Ø×•× ×™× |
| `render_trigger_deploy` | āš ļø ×”×¤×¢×œ×Ŗ דפלוי חדש |
| `render_restart_service` | āš ļø ×Ø×™×”×˜××Ø×˜ ×œ×©×™×Ø×•×Ŗ |
| `render_get_env_vars` | הצגת ×ž×©×Ŗ× ×™ הביבה (×¢×Ø×›×™× ×Ø×’×™×©×™× ×ž×•×”×Ŗ×Ø×™×) |

### šŸ™ GitHub Issues
| כלי | תיאור |
|------|--------|
| `github_create_issue` | יצירת Issue חדש (×Ŗ×•×ž×š Markdown) |
| `github_list_issues` | ×Ø×©×™×ž×Ŗ Issues עם הינון |

### šŸ“‹ Prompts מובנים (בעברית)
| ×¤×Ø×•×ž×¤×˜ | תיאור |
|---------|--------|
| `code_review` | הקירת קוד ×ž×§×¦×•×¢×™×Ŗ |
| `debug_help` | ניתוח שגיאה והצעת פתרונות |
| `create_github_issue_prompt` | תבנית Issue (bug / enhancement) |
| `deploy_check` | בדיקות ×‘×˜×™×—×•×Ŗ לפני דפלוי |
| `summarize_logs` | ניתוח לוגים וזיהוי שגיאות |
| `optimize_snippet` | הצעות אופטימיזציה |

---

## šŸš€ ×”×Ŗ×§× ×”

### הרצה ×ž×§×•×ž×™×Ŗ

```bash
git clone https://github.com/YOUR_USERNAME/codebot-mcp-server.git
cd codebot-mcp-server

python -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

cp .env.example .env
# ×¢×Ø×•×š את .env

python server.py
```

השרת עולה על `http://localhost:8000/mcp`

### דפלוי ל-Render

1. העלה ל-GitHub
2. ב-Render: **New → Web Service → Docker**
3. הגדר ×ž×©×Ŗ× ×™ הביבה:

| ×ž×©×Ŗ× ×” | חובה? | תיאור |
|--------|-------|--------|
| `MONGO_URI` | āœ… | Connection string ל-MongoDB |
| `RENDER_API_KEY` | ⬜ | Render API token (ל-deploy/restart) |
| `RENDER_SERVICE_ID` | ⬜ | מזהה השירות ב-Render |
| `GITHUB_TOKEN` | ⬜ | GitHub PAT (ל-Issues) |
| `GITHUB_REPO` | ⬜ | `owner/repo` |

> **šŸ’” טיפ**: רק `MONGO_URI` חובה. שאר ×”××™× ×˜×’×Ø×¦×™×•×Ŗ עובדות ×›×©×”×ž×©×Ŗ× ×™× שלהן ×ž×•×’×“×Ø×™×.

---

## šŸ”Œ חיבור ל-Claude

### Claude.ai (Pro / Max / Team / Enterprise)

**Settings → Integrations → Add custom connector**

```
URL: https://YOUR-APP.onrender.com/mcp
```

### Claude Desktop

הוהף ל-`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "codebot": {
      "type": "streamable-http",
      "url": "https://YOUR-APP.onrender.com/mcp"
    }
  }
}
```

### Claude Code

```bash
claude mcp add-json codebot '{"type":"streamable-http","url":"https://YOUR-APP.onrender.com/mcp"}'
```

---

## šŸ’¬ ×“×•×’×ž××•×Ŗ שימוש ב-Claude

### ניהול קוד
> *"הראה לי את כל ה-snippets שלי ב-Python ×©×§×©×•×Ø×™× ל-async"*
>
> *"צור snippet חדש עם פונקציה למיון ×ž×”×™×Ø"*
>
> *"חפש בקוד שלי שימוש ב-try/except"*

### ניתוח קוד
> *"תעשה code review על ה-snippet הזה"* (מפעיל את ×”×¤×Ø×•×ž×¤×˜ code_review)
>
> *"יש לי שגיאה: ModuleNotFoundError: No module named 'redis'"*

### דפלוי ×•×Ŗ×¤×¢×•×œ
> *"מה ההטטוה של השירות שלי ב-Render?"*
>
> *"תעשה דפלוי חדש"* (מפעיל deploy_check ×œ×‘×“×™×§×Ŗ ×‘×˜×™×—×•×Ŗ)
>
> *"תפתח Issue על הבאג שמצאנו"*

### לוגים
> *"× ×Ŗ×— לי את הלוגים האלה ותגיד מה לא ×Ŗ×§×™×Ÿ"*

---

## šŸ“ מבנה

```
codebot-mcp-server/
ā”œā”€ā”€ server.py          # שרת MCP (כל הכלים, prompts, resources)
ā”œā”€ā”€ requirements.txt   # ×Ŗ×œ×•×™×•×Ŗ
ā”œā”€ā”€ Dockerfile         # Docker image
ā”œā”€ā”€ render.yaml        # Render Blueprint
ā”œā”€ā”€ .env.example       # דוגמה ×œ×ž×©×Ŗ× ×™×
ā”œā”€ā”€ .gitignore
└── README.md
```

---

## šŸ”’ אבטחה

- **Stateless mode** — ×ž×Ŗ××™× ל-horizontal scaling
- **×¢×Ø×›×™× ×Ø×’×™×©×™×** ×ž×•×”×Ŗ×Ø×™× ב-`render_get_env_vars`
- **אישור נדרש** לפני deploy/restart (×“×Ø×š ×”×¤×Ø×•×ž×¤×˜ `deploy_check`)
- **אין secrets בקוד** — הכל ×“×Ø×š ×ž×©×Ŗ× ×™ הביבה

---

## šŸ“„ ×Ø×™×©×™×•×Ÿ

MIT