manim-mcp-rag

# 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

Related MCP server: Manim MCP Server

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

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.