manim-server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@manim-serverCreate a new scene with a blue circle and a green square."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
manim-server
FastAPI + MCP server for trusted Manim script rendering. (uses Manim Community)
Install
uv sync --all-groupsRelated MCP server: Animated Video MCP Server
Configure
Create .env from the example:
cp .env.example .envSupported keys:
HOST=127.0.0.1
PORT=8000
DATA_DIR=.manim-server-data
TEMPLATE_DIR=template
MANIM_CLI_FLAGS=-ql
MANIM_TIMEOUT_SECONDS=120Notes:
DATA_DIRstores session JSON logs and rendered MP4 artifacts.TEMPLATE_DIRstores named full-wrapper Manim templates.MANIM_CLI_FLAGSis split like a shell command, then passed as subprocess args. Common values:-ql,-qm,-qh,-ql --fps 30.--save_sections,--media_dir, cache flags, scene path, and scene class are managed by the server.
Run
make runDefault server: http://127.0.0.1:8000.
Docker
Build the image:
make docker-buildRun it on http://127.0.0.1:8000:
make docker-runSmoke-test the image:
make docker-smokeThe image is based on manimcommunity/manim:v0.20.1, matching the locked Manim dependency. That base image provides the Manim CLI plus common native rendering dependencies such as ffmpeg, Cairo/Pango, fonts, and minimal TeX Live. If a scene needs an extra TeX package, extend the image with that specific package instead of preinstalling all of TeX Live.
REST flow
The example builds one session from five Manim snippets, renders the final scene,
then downloads the MP4. Use Manim-Session-ID when you want a stable id; omit it
to let the server generate one.
# POST /sessions creates a new scene session.
# Response includes sessionId, title, sectionCount, and an empty section log.
curl -sS -X POST http://127.0.0.1:8000/sessions \
-H 'content-type: application/json' \
-H 'Manim-Session-ID: five-section-demo' \
-d '{"title":"Five animated sections curl smoke"}'
# POST /sessions/<sessionId>/section appends one Manim code section.
# render=false records code without invoking Manim; cache is ignored until rendering.
curl -sS -X POST http://127.0.0.1:8000/sessions/five-section-demo/section \
-H 'content-type: application/json' \
-d '{"title":"Create blue circle","code":"circle = Circle(color=BLUE)\nself.play(Create(circle), run_time=1.0)","render":false}'
# Another section. Sections run in append order inside the generated scene.
curl -sS -X POST http://127.0.0.1:8000/sessions/five-section-demo/section \
-H 'content-type: application/json' \
-d '{"title":"Create green square","code":"square = Square(color=GREEN).shift(RIGHT * 2)\nself.play(Create(square), run_time=1.0)","render":false}'
# Adds a third shape, still only updating the session JSON log.
curl -sS -X POST http://127.0.0.1:8000/sessions/five-section-demo/section \
-H 'content-type: application/json' \
-d '{"title":"Create yellow triangle","code":"triangle = Triangle(color=YELLOW).shift(LEFT * 2)\nself.play(Create(triangle), run_time=1.0)","render":false}'
# Adds a fourth animation section.
curl -sS -X POST http://127.0.0.1:8000/sessions/five-section-demo/section \
-H 'content-type: application/json' \
-d '{"title":"Create lower line","code":"line = Line(LEFT, RIGHT, color=RED).shift(DOWN * 1.5)\nself.play(Create(line), run_time=1.0)","render":false}'
# Final section render=true appends code and runs Manim. cache defaults to "use",
# so omitting it lets Manim reuse existing cached partial movie files.
curl -sS -X POST http://127.0.0.1:8000/sessions/five-section-demo/section \
-H 'content-type: application/json' \
-d '{"title":"Create purple ellipse","code":"ellipse = Ellipse(width=3, height=1.5, color=PURPLE).shift(UP * 1.5)\nself.play(Create(ellipse), run_time=1.0)\nself.wait(0.1)","render":true}'
# GET /sessions/<sessionId>/video downloads the full MP4 from the latest render.
curl -sS -o /tmp/five-sections-full.mp4 \
-w 'status=%{http_code} content_type=%{content_type} bytes=%{size_download}\n' \
http://127.0.0.1:8000/sessions/five-section-demo/videoOpen returned latestRender.fullVideoUrl, or a section URL such as
/sessions/five-section-demo/sections/0001/video, in a browser or video client.
Cache modes for append_section with render=true, and for render_scene:
Omit
cache, or set"cache":"use": default; let Manim reuse cache."cache":"flush": delete Manim partial movie cache before rendering."cache":"disable": pass--disable_cachingto Manim for that render.
Session templates
POST /sessions accepts optional templateId:
curl -sS -X POST http://127.0.0.1:8000/sessions \
-H 'content-type: application/json' \
-d '{"title":"Lecture","templateId":"lecture"}'Template assets are Python files under TEMPLATE_DIR/<templateId>.py.
By default this is ./template/<templateId>.py. Unknown missing templates
fall back to default.py; if default.py is absent, session creation fails
until the template directory is fixed.
Bundled templates:
default: plain title header.clean-title: title header with underline.dark-grid: dark background with faint coordinate grid.presentation-card: animated title card intro, then clears before sections.
Template files are full Manim scripts, not scene-body snippets. Keep the scene
class named GeneratedScene; Manim renders that class, and user sections are
appended at EOF at the construct() body indentation. Do not put dedented code
after construct() that would close that append point.
The reserved string literals "__SESSION_ID__", "__SESSION_TITLE__", and
"__TEMPLATE_ID__" are replaced before render. Include them where the template
needs those values:
from manim import *
from manim.opengl import *
class GeneratedScene(Scene):
def construct(self):
# DO NOT EDIT: replaced by manim-server before render.
session_id = "__SESSION_ID__"
session_title = "__SESSION_TITLE__"
template_id = "__TEMPLATE_ID__"
title = Text(session_title or "Untitled").to_edge(UP)
self.add(title)
# user sections append hereMCP endpoint
http://127.0.0.1:8000/mcp
Tools mirror REST: create_session, list_sessions, get_session, close_session, append_section, render_scene, reset_session.
Thanks
Special thanks to the Manim Community and 3Blue1Brown for their amazing work and inspiration.
Security
Scene code is trusted Python. Do not expose this server to untrusted users or networks.
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceA server-based tool that enables the generation of mathematical animations from natural language prompts by leveraging Manim.Last updated16
- Alicense-qualityDmaintenanceAn MCP server that executes Manim Python scripts to generate and return rendered animations. It enables users to create mathematical and programmatic videos dynamically through natural language interfaces.Last updated3MIT
- Alicense-qualityAmaintenanceExposes manimgl mathematical animation functionality as MCP tools, enabling LLMs to create animated scenes with narration and background music, and render to video.Last updatedMIT
- AlicenseAqualityDmaintenanceMCP server that generates 3Blue1Brown-style math videos with Manim and AI voiceover directly inside Claude Desktop.Last updated217MIT
Related MCP Connectors
MCP server for Wan AI video generation
MCP server for Hailuo (MiniMax) AI video generation
MCP server for Grok Imagine AI video generation
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sagebynature/manim-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server