# Manim MCP — DeepSeek Only

Altin Kural: Sadece DeepSeek. Baska hicbir LLM provider YOK. OpenAI SDK → DeepSeek endpoint. Google Gemini, OpenAI, Claude import edilmez.

Manim ile matematik animasyonlari ureten MCP sunucusu. DeepSeek LLM + ChromaDB tabanli RAG ile ilgili Manim kod orneklerini getirip, kullanici istedigi animasyonu uretir ve render eder.

Ozellikler

🎬 Manim Community animasyon uretimi (DeepSeek deepseek-chat / deepseek-reasoner)
🧠 ChromaDB tabanli RAG — vektor arama ile ilgili kod orneklerini getirir
📚 Coklu kaynak indexleme — 3Blue1Brown videolari, animg kutuphanesi, Manim Kindergarten verisi, Pisagor ve ozel sahneler
📖 Storyboard katmani — sahne planini JSON olarak uretir (storyboard.json)
🔄 Geri besleme dongusu — basarili render'lar RAG'e geri beslenir (feed_rag.py)
🖥️ CLI + MCP — hem terminal hem VS Code MCP uzerinden kullanilabilir

Hizli Baslangic

# 1. Kur
pip install -r requirements.txt

# 2. .env dosyasini duzenle (DEEPSEEK_API_KEY zorunlu)
#    .env.example dosyasini .env olarak kopyala, API keyini yaz

# 3. (Istege bagli) RAG indexlerini olustur
python index_animg.py
python index_3b1b_videos.py
python index_pisagor.py

# 4. Sunucuyu baslat (1. terminal)
python server.py

# 5. CLI'yi baslat (2. terminal)
python cli.py

# 6. Test et
>>> Bir daire ciz ve kaydir
>>> /doc How to animate a square transforming into a circle
>>> /health

Mimarisi

                      ┌── index_*.py ──▶ ChromaDB (chroma_data/)
                      │
storyboard.json ◀── generate_storyboard.py
                      │
cli.py ──HTTP──▶ server.py ──OpenAI SDK──▶ api.deepseek.com
                      │                          │
                      ├── manim_mcp (manim-mcp-original)
                      │     ├── core/rag.py        (ChromaDBService - RAG)
                      │     ├── core/tracker.py    (RenderTracker)
                      │     ├── prompts/           (system prompt sablonlari)
                      │     └── config.py          (ManimMCPConfig)
                      │
render_with_rag.py ◀── RAG retrieval (5 koleksiyon: patterns, components, helpers, scenes, 3b1b)
                      │
                      └── feed_rag.py ──▶ basarili render'lar RAG'e geri beslenir

Dosyalar

Dosya	Gorevi
`server.py`	Flask MCP sunucusu (JSON-RPC)
`cli.py`	Terminal arayuzu
`deepseek_client.py`	OpenAI SDK ile DeepSeek API
`manim_tools.py`	MCP tool tanimlari (DeepSeek/OpenAI format)
`config.py`	.env tabanli yapilandirma (DeepSeek + MCP + Manim + RAG)
`render_with_rag.py`	RAG destekli animasyon uretim pipeline'i
`generate_storyboard.py`	Storyboard JSON uretici (ornek: Pisagor)
`feed_rag.py`	Basarili render'lari ChromaDB'ye besler
`index_animg.py`	animg kutuphanesi → ChromaDB
`index_3b1b_videos.py`	3Blue1Brown videolari → ChromaDB
`index_pisagor.py`	Pisagor ozel verisi → ChromaDB
`index_manim_kindergarten.py`	Manim Kindergarten verisi → ChromaDB
`index_custom_scene.py`	Ozel sahneler → ChromaDB
`manim-mcp-original/manim_mcp/`	Cekirdek paket (RAG, tracker, promptlar)
`storyboard.json`	Ornek storyboard tanimi
`mcp.template.json`	VS Code MCP yapilandirmasi
`.env.example`	Sablon .env dosyasi

RAG (ChromaDB)

Embedding ve vektor arama ChromaDB uzerinden yapilir (TF-IDF degil)
Veri yolu: MANIM_MCP_CHROMADB_PATH (varsayilan: ./chroma_data)
render_with_rag.py 5 koleksiyondan paralel ceker: patterns, components, helpers, scenes, 3b1b
RAG protokolu icin: RAG_PROTOCOL.md

Testler

python test_code_generation.py   # kod uretim testi
python test_critical.py          # kritik akis testleri
python test_precision.py         # hassasiyet testleri
python test_production.py        # uretim testleri

Neden DeepSeek?

Orijinal paulnegz/manim-mcp reposu google.generativeai kullanir. Bu su demek:

Kod Gemini SDK import eder ama DEEPSEEK_API_KEY ayarlanmistir
Google SDK GOOGLE_API_KEY arar, DeepSeek keyini yok sayar
Ya crash olur ya da sessizce Geminiye gider

Bizim cozumumuz: from openai import OpenAI + base_url="https://api.deepseek.com" DeepSeek, OpenAI API uyumlu oldugu icin baska hicbir SDKya gerek yok.

MCP Olarak Kullan

mcp.template.json dosyasini VS Code MCP ayarlarina kopyala, DEEPSEEK_API_KEYi yaz.

manim-mcp-rag