Manim MCP — DeepSeek Only

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

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. Sunucuyu baslat (1. terminal)
python server.py

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

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

Mimarisi

cli.py ──HTTP──▶ server.py ──OpenAI SDK──▶ api.deepseek.com
                     │
                     ├── deepseek_client.py   (DeepSeek API wrapper)
                     ├── manim_tools.py        (MCP tool definitions)
                     ├── rag.py                (TF-IDF retrieval)
                     └── config.py             (.env based config)

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)
rag.py	TF-IDF RAG (DeepSeek embedding cikinca degisecek)
config.py	.env tabanli yapilandirma
.env.example	Sablon .env dosyasi
mcp.template.json	VS Code MCP yapilandirmasi

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.