MathMagic MCP Pro
Click on "Deploy 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., "@MathMagic MCP Pro insert \frac{3}{4} into the InDesign frame at marker [[MM:Q0001-M1]]"
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.
MathMagic MCP Pro (Windows / InDesign 2026) · v0.4.2
Bu MCP sunucusu, Claude (Claude Code / Claude Desktop) ile Adobe InDesign 2026 ve MathMagic Pro 9.31 InD arasında çalışır. InDesign metin çerçevelerine yerel, düzenlenebilir, gömülü MathMagic formülleri yerleştirir. Bu iş arka planda yürür; siz başka programlarda çalışmaya devam edebilirsiniz. Mevcut InDesign MCP'nizi değiştirmez, onun yanında ayrı bir araç seti olarak çalışır.
Depo: https://github.com/mrtersn9-cpu/mathmagic-mcp-pro Proje önceden
e-icerik_editordeposununtools/mathmagic-mcp-proklasöründeydi. 17.11.2026'da commit geçmişi korunarak bu bağımsız depoya taşındı.
Temel ilkeler
Yalnız pencere mesajları ve InDesign COM kullanılır.
MathMagic
WM_CHAR,WM_COMMAND,WM_SETTEXTveBM_CLICKmesajlarıyla yönetilir.InDesign, sabit JSX içeren
DoScriptçağrılarıyla yönetilir.Klavye/fare simülasyonu, pano,
SetFocus/SetForegroundWindowve ekran görüntüsü/OCR kullanılmaz.
Tek kanal. MathMagic yalnız bu sunucunun
mathmagic_*araçlarıyla sürülür. Windows MCP, computer-use veya tuş/fare gönderen betikler MathMagic ya da InDesign penceresinde kullanılmaz. Bu kural, sunucunun istemciye verdiği talimatlarda da yer alır.Lisans/Try penceresine dokunulmaz. Araç
LICENSE_REQUIREDdöndürür; pencereyi kullanıcı kapatır.Onay gerekir. Değişiklik yapan her araç
confirm=trueister. Süreçler arası kilit vardır: başka bir oturum çalışıyorsa araçBUSYdöndürür.Kaydetme yalnız istenirse yapılır (
save_everyveyamathmagic_save_document). Formül eklemeden öncemathmagic_backup_inddile yedek alınır.
Related MCP server: InDesign MCP Server
Mimari
Claude
├── InDesign MCP ─────────── metin çerçeveleri, stiller, sayfalama, tekil [[MM:ID]] işaretçileri
└── mathmagic-mcp-pro (stdio, yerel Python)
├── çevrimdışı mod (varsayılan, odak almaz)
│ MathMagic: temizle + LaTeX yaz + TeX dönüştür (tek mesaj kuyruğu) → Save As EPS (+ LaTeX geri doğrulama)
│ InDesign: işaretçiye satır içi yerleştir, göm, %100 ölçek, Default Baseline, etiketle, tek "Geri Al" adımı
└── eklenti modu: InDesign MathMagic eklentisi New/Edit Equation + Update (pencereleri öne getirir)Araçlar (27)
Salt okunur:
mathmagic_policy,mathmagic_preflight,mathmagic_status,mathmagic_capabilities(213 menü komutu ve 13 eklenti eyleminin canlı envanteri)mathmagic_inspect_indesign,mathmagic_probe_uia,mathmagic_preview_equation,mathmagic_preview_batchmathmagic_verify_equation,mathmagic_list_equations,mathmagic_get_style,mathmagic_capture_editor
Değişiklik yapanlar (confirm=true gerekir):
mathmagic_launch,mathmagic_dismiss_dialogsmathmagic_create_equation,mathmagic_edit_equationmathmagic_export_equation(EPS, SVG, MathML, PNG, LaTeX…),mathmagic_render_eps,mathmagic_place_epsmathmagic_run_batch,mathmagic_rerender_equationsmathmagic_set_style,mathmagic_apply_stylesetmathmagic_prepare_offline_batch,mathmagic_backup_indd,mathmagic_save_document,mathmagic_cleanup_marker
Ayrıntılar: docs/PRO_V04_TR.md · Komut envanteri: docs/MATHMAGIC_KOMUT_ENVANTERI_TR.md
Soru bankası iş akışı
mathmagic_preflightçalıştırılır. Ardından kitap yazı tipi ve puntosu bir kezmathmagic_set_styleile verilir. Örnek:name="SB Matematik 10.4",font="Times New Roman",size_pt=10.4,variable_italic=true.InDesign MCP metni yazar. Her formülün yerinde tekil bir işaretçi bulunur (
[[MM:Q0001-M1]]). Ardından belge kaydedilir.Sırasıyla
mathmagic_backup_inddvemathmagic_preview_batchçalıştırılır.Toplu iş çalıştırılır:
mathmagic_run_batch(manifest_path, document, mode="offline", verify_latex=true, remove_markers=true, time_budget_s=600, save_every=50, confirm=true)next_indexdoluysa aynı çağrıstart_index=next_indexile tekrarlanır.mathmagic_list_equationsile kontrol edilir. Belgede[[MM:kalmamalı;placeholdersvenot_embedded0 olmalı.
Manifest biçimi: {"equations":[{"id":"Q0001-M1","marker":"[[MM:Q0001-M1]]","latex":"\\frac{3}{4}","size_pt":11.5}]}
soru-bankasi-uret-pro skill'i soru bankası JSON'undan işaretçili InDesign iş emirlerini ve ünite bazlı manifestleri otomatik üretir (scripts/prepare_mathmagic.py). Protokolü indesign/MATHMAGIC-ENTEGRASYON.md belgesindedir.
Dizgi notu: Üst üste kesir içeren satır içi formül paragraflarına sabit satır aralığı verin (metin puntosunun yaklaşık 1,75 katı). Otomatik satır aralığı MathMagic'in taban çizgisi kaydırmasını hesaba katmaz ve kesirler üst üste biner (canlı test).
Geometri: üçgen şapka ve yay (v0.4.2)
Yazım | Sonuç | MathMagic şablonu |
| Açı ölçüsü: DEF üzerinde geniş üçgen şapka | Wide Hat, |
| Yay | Over Elliptical Arc, |
| Tek harf üzerinde küçük şapka | Hat (yalnız tek harf) |
Neden gerekli? MathMagic'in TeX dönüştürücüsü \widehat komutunu desteklemiyor ve içeriği siliyor (m(\widehat{DEF}) → m()). \hat{DEF} ise şapkayı yalnız D'ye koyuyor ve kapanış parantezini içeri alıyor. \overset{\wedge} küçük bir ∧ işaretini havada bırakıyor. Hepsi canlı testte görüldü.
Nasıl çalışır?
Sunucu formülü önce
\overbraceyer tutucusuyla yazar ve yapıyı LaTeX ile doğrular.Formülü MathMagic'in kendi
.mmfmetin biçiminde kaydeder ve simgeyiV(42)(şapka) ya daV(19)(yay) yapar.Dosyayı File > Open ile, yine yalnız pencere mesajlarıyla yeniden açar ve EPS'e aktarır.
Sonuç EPS'i normal bir MathMagic formülü gibi düzenlenebilir; MathMagic'in LaTeX çıktısı \widehat{DEF} olur. Yanıttaki native_accents alanı kullanılan simgeleri gösterir.
Sınırlar:
\overbraceaynı formülde kullanılamaz (yer tutucu); bu durumda sonuçNATIVE_ACCENT_UNSUPPORTEDolur.Şapka ve yay yüksekliği StyleSet'teki "Embellishment height" değeridir,
size_ptile büyümez (10–12 pt kitap puntolarında orantılıdır).
Sonuç durumları
Durum | Anlamı |
| Formül yerleşti, gömüldü, EPS'te MathMagic formül verisi (MMF) var, LaTeX doğrulaması geçti |
| Aynı LaTeX daha önce eklenmiş (etiketteki SHA eşleşti) |
| MathMagic farklı bir yapı kurdu. |
| Formül iki denemede de boş çıktı (yazılan karakterler kayboldu); yeniden çalıştırılır |
| Lisans/Try penceresi açık; kullanıcı kapatır |
| İşaretçi yok ya da birden fazla |
| Başka bir oturum MathMagic kilidini tutuyor |
|
|
Kurulum (Claude Code)
Gerekenler: Windows 10/11, Python 3.10+, pywin32, Adobe InDesign 2026, MathMagic Pro 9.31 InD ve InDesign Plug-Ins\MathMagic CC2026-64bit eklentisi.
git clone https://github.com/mrtersn9-cpu/mathmagic-mcp-pro.git C:\Users\<kullanıcı>\mcp-servers\mathmagic-mcp-pro
cd C:\Users\<kullanıcı>\mcp-servers\mathmagic-mcp-pro
python -m venv .venv
.\.venv\Scripts\pip install -r requirements-windows.txt
.\.venv\Scripts\pip install pytest
.\.venv\Scripts\python -m pytest -q tests # 87 testmathmagic-mcp-pro.json dosyası (yolları kendi klasörünüze göre düzeltin):
{"type":"stdio","command":"C:\\...\\mathmagic-mcp-pro\\.venv\\Scripts\\python.exe",
"args":["-u","C:\\...\\mathmagic-mcp-pro\\server_pro.py"],
"env":{"MATHMAGIC_EXE":"C:\\Program Files (x86)\\MathMagic Pro Edition\\MathMagic Pro 9.31 InD.exe",
"MATHMAGIC_DEFAULT_MODE":"offline"}}# Git Bash (Windows PowerShell 5.1, yerel programlara verilen JSON'daki tırnakları siler)
claude mcp add-json mathmagic-mcp-pro "$(cat mathmagic-mcp-pro.json)" -s userinstall.ps1 eski v0.1 sunucusunu (server.py) Claude Desktop'a kaydeder. Pro sürüm için yukarıdaki kaydı kullanın. Kayıttan sonra yeni bir Claude oturumu açın. Mevcut InDesign MCP kaydına dokunulmaz.
Ölçülen hız (deneme modu)
Mod | Süre |
Çevrimdışı, LaTeX doğrulaması kapalı | 1,8–2,3 sn/formül |
Çevrimdışı, LaTeX doğrulaması açık | 2,8–4,5 sn/formül (uzun oturumda yükselir; çalışma belgesi 25 kullanımda bir tazelenir) |
Eklenti modu | 2,5–2,8 sn/formül; pencereleri öne getirir |
Lisanslı sürümde toplu dönüştürme (File > Convert) daha hızlı bir yol olabilir; deneme sürümü bunu engelliyor, henüz test edilmedi.
Neler doğrulandı, neler doğrulanmadı
✅ Canlı uçtan uca test (17.11.2026, test belgesi). Soru bankası örneğindeki 16 formül çevrimdışı modda yerleşti; sonuçlar
INSERTED_VERIFIEDve LaTeX doğrulamasıEQUIVALENT/EXACT. Hiçbir işlem kullanıcının uygulamasından odak almadı. Formüllerin tamamı gömülü ve tek StyleSet'te.✅ Yazı tipi seçimi: StyleSet'te Times New Roman uyarısız çalıştı. Myriad Pro ve Helvetica Neue, MathMagic'te yazı tipi uyarısı veriyor.
✅ Kullanıcı girdisi koruması: Kullanıcı Alt+Tab ile Alt tuşunu basılı tutarken MathMagic'e giden karakterler kayboluyordu. Araç artık tuşun bırakılmasını bekliyor ve boş formülü bir kez yeniden deniyor (canlı doğrulandı).
✅ Geometri şapkası (v0.4.2):
m(\widehat{DEF}),m(\widehat{ABC})=60^{\circ},\widehat{E}+\widehat{F}=90^{\circ}vem(\overarc{AB})canlı üretildi:RENDERED, LaTeXEQUIVALENT, odak alınmadı. Doğrulama kapalıyken de çalışıyor.✅ Birim testleri: 87 test geçiyor.
⚠️ Doğrulanmayanlar:
Tablo hücresindeki işaretçi canlı denenmedi. InDesign MCP'nin tablo araçları bu ortamda hata verdi.
PDF dışa aktarma Helvetica Neue stilinde MathMagic hatası veriyor.
Lisanslı sürüm davranışı: "Demo" filigranı, açılış penceresi ve toplu dönüştürme.
❌ Bilinen sınırlar:
Eklenti modu pencereleri öne getirir.
Deneme sürümü her yeni süreçte lisans penceresi açar.
Formüllerin matematiksel doğruluğunu ve son baskı kalitesini insan editör onaylar.
Belgeler
Arka plan modu · Mimari · API
Eski sürümler: v0.3 · Kurulum (v0.1)
Lisans
Kaynak kodu LICENSE altındaki MIT lisansıyla sağlanır. MathMagic ve Adobe InDesign ticari ürünlerdir ve bu depoya dahil değildir.
Available Tools
27 toolsmathmagic_apply_stylesetB
Make an existing StyleSet (see get_style) MathMagic's default, e.g. to restore the backup.
Inputs: name (required), confirm, make_default.
mathmagic_backup_inddB
Copy the last saved .indd to another folder (unsaved changes excluded).
Inputs: folder (required), confirm, document.
mathmagic_capabilitiesA
Read-only live inventory of ALL MathMagic menu commands and InDesign plugin actions, classified for automation.
Inputs: no named parameters.
mathmagic_capture_editorA
Save a PNG of the open MathMagic equation window (PrintWindow, no focus change).
Inputs: out_png (required).
mathmagic_cleanup_markerB
Remove an [[MM:ID]] marker; by default only if a verified equation precedes it.
Inputs: marker (required), confirm, document, require_equation.
mathmagic_create_equationA
Insert a native MathMagic equation at an [[MM:ID]] marker (no keyboard/mouse/clipboard); returns verification, timing and a focus report. One InDesign undo step (offline).
Inputs: latex (required), marker (required), id, mode, +8 more.
mathmagic_dismiss_dialogsA
Acknowledge only known harmless MathMagic dialogs (font warning, Tip of the Day). Never the license dialog.
Inputs: confirm.
mathmagic_edit_equationA
Replace the equation before [[MM:ID]] with new LaTeX (offline: re-render + replace; plugin: Edit Equation).
Inputs: latex (required), marker (required), mode, confirm, +4 more.
mathmagic_export_equationB
Render LaTeX with MathMagic to a file; format from the extension: .eps .pdf .svg .png .jpg .gif .bmp .wmf .mmf .mml/.mathml/.html (MathML) .tex (LaTeX, ams=true for AMS) .amath .mathtxt.
Inputs: latex (required), out_path (required), ams, confirm, +4 more.
mathmagic_get_styleA
Read-only: MathMagic's current default style (fonts per role, base size) and available StyleSets.
Inputs: no named parameters.
mathmagic_inspect_indesignA
Read-only InDesign probe (never launches InDesign): documents, selection, MathMagic plugin actions.
Inputs: no named parameters.
mathmagic_launchA
Start MathMagic without activating it; reports LICENSE_REQUIRED if the Authorization dialog appears.
Inputs: confirm.
mathmagic_list_equationsA
Read-only inventory of MathMagic equations in a document (ids, page, embedded, style, optional LaTeX).
Inputs: deep, document, include_latex.
mathmagic_place_epsB
Place a MathMagic EPS inline at [[MM:ID]] (fit, embed, Default Baseline, label) as one undo step.
Inputs: marker (required), eps_path (required), id, embed, +5 more.
mathmagic_policyC
What this server does and never does; modes, synchronisation and focus behaviour.
Inputs: no named parameters.
mathmagic_preflightA
Read-only readiness check (files, pywin32, InDesign/MathMagic running and responsive, license dialog).
Inputs: no named parameters.
mathmagic_prepare_offline_batchC
Write each manifest LaTeX to .tex in an empty folder (inputs only).
Inputs: output_dir (required), manifest_path (required), confirm.
mathmagic_preview_batchA
Validate a JSON manifest (up to 5000 equations; optional per-item size_pt). No changes.
Inputs: manifest_path (required).
mathmagic_preview_equationB
Validate LaTeX/marker/size and show the planned steps. No changes.
Inputs: latex (required), mode, marker, size_pt.
mathmagic_probe_uiaB
Read-only UI Automation capability scan of MathMagic with modal-dialog detection.
Inputs: no named parameters.
mathmagic_render_epsB
Alias of mathmagic_export_equation for .eps output.
Inputs: latex (required), out_path (required), confirm, size_pt, +3 more.
mathmagic_rerender_equationsC
Re-render labelled equations from their stored LaTeX with the current StyleSet and replace them in place.
Inputs: ids, confirm, eps_dir, document, +2 more.
mathmagic_run_batchA
Process a manifest ({equations:[{id,marker,latex,size_pt?}]}, e.g. from soru-bankasi-uret-pro prepare_mathmagic.py) within a time budget; skips finished items, journals progress, relaunches MathMagic if it exits, retries an empty equation once, optional periodic save. Stops on the first error (LATEX_MISMATCH shows latex_exported). Returns next_index to continue.
Inputs: manifest_path (required), mode, confirm, eps_dir, +10 more.
mathmagic_save_documentB
Save the InDesign document in place (only if it already has a file).
Inputs: confirm, document.
mathmagic_set_styleA
Create a StyleSet (font for text/function/variable/vector/number, base size pt, italic variables) from the current default, back up the old default as a StyleSet, make it MathMagic's default and verify with a probe render.
Inputs: name (required), font, confirm, size_pt, +6 more.
mathmagic_statusC
Read-only: MathMagic windows/documents/dialogs, InDesign documents and plugin actions, style state, foreground.
Inputs: no named parameters.
mathmagic_verify_equationC
Read-only: native MathMagic equation before [[MM:ID]]? Link, embedding, plugin recognition, labels.
Inputs: marker (required), document.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
The read-only diagnostic tier overlaps heavily: mathmagic_status already covers MathMagic windows, InDesign documents and plugin actions, which is also what mathmagic_inspect_indesign and mathmagic_capabilities report, so an agent must guess which probe to run. Similarly, preview_equation, preview_batch and prepare_offline_batch share a validation-only purpose that only the descriptions disambiguate, and render_eps is an admitted alias of export_equation. The create/edit/rerender/style tools are cleanly distinct, so the overlaps are contained rather than pervasive.
Every tool carries the mathmagic_ prefix and most follow a verb_noun pattern (create_equation, edit_equation, list_equations, get_style, set_style, save_document). A handful are bare nouns with no verb (policy, preflight, status, capabilities), which is a minor deviation but still readable and predictable. No camelCase/snake_case mixing.
At 27 tools the surface is heavy for the domain and several are redundant rather than earning their place: an explicit .eps alias of export_equation, three separate preview/validation tools, and four or five overlapping read-only probes. The core workflow (create/edit/verify/style/batch) could be expressed in roughly half the tools.
Coverage is genuinely broad: readiness checks, launch/dialog handling, create/edit/rerender, multi-format export, style set lifecycle, batch processing, verification, marker cleanup, document save and .indd backup. The main gap is that there is no explicit delete/remove-equation operation separate from cleanup_marker, and no document open/close handling, but these are minor for the stated purpose.
Maintenance
Related MCP Connectors
TeX math, TikZ figures, and tables in the PowerPoint or Word file you have open, from chat.
Edit your Overleaf LaTeX projects from Claude and ChatGPT; every change is a real Git commit.
Persistent AI LaTeX workspace: edit and compile multi-file projects, export publication-ready PDFs.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables text manipulation in Adobe InDesign documents via Claude Desktop by providing tools to add, update, remove, and retrieve text content through ExtendScript API.20-
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe InDesign for automated publishing workflows, document creation, and layout tasks across macOS and Windows.363MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to control Adobe InDesign on Windows via the Model Context Protocol, allowing document inspection, text and style editing, and exports to formats like PDF, images, and EPUB.1995 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to create and edit Adobe InDesign documents, including pages, text frames, styles, images, and previews.25 npmMIT