interactive-game-mcp
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., "@interactive-game-mcp Create a 4-pair matching game about food groups for 4th grade science."
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.
Eğiteknoloji Etkileşimli İçerik Player Kabuğu & MCP Sunucusu
Bu proje; Eğiteknoloji kurumsal marka kimliği ve renk paletine tam uyumlu, 16:9 oranını koruyarak tüm cihazlarda (akıllı tahta, tablet, mobil, masaüstü) milimetrik olarak ölçeklenen, SCORM 1.2 uyumlu ve yapay zeka ajanlarının doğrudan içerik üretebilmesi için tasarlanmış bir Etkileşimli İçerik Player Kabuğu ve MCP (Model Context Protocol) Sunucusudur.
🎨 1. Tasarım & Mimari Standartları
Kurumsal Renk Paleti (Eğiteknoloji Standartları)
Ana Kurumsal (Primary):
#052249(Derin Okyanus Laciverti - Üst/alt çerçeve, kurumsal güven)Ana Vurgu (Accent / CTA):
#6cb22f(Zümrüt Yeşili - Doğru cevaplar, onay, başarı butonları)Destekleyici Mavi:
#086cd9(İlerleme çubukları, kart seçimi, hiperlinkler)Açık Buz Mavisi:
#8fc3ff(Hover fonları, rozet zeminleri)Açık Bölüm Fonu:
#eaf4ff(İçerik kartı zeminleri, bilgi kutuları)Nötr Tuval Zemin:
#f8f8f9(Temiz ve sade açık arka plan)Yüksek Kontrastlı Metin:
#080808
16:9 Otomatik Responsive Ölçekleme (Viewport Scaler)
Referans Çözünürlük:
1280 x 720px.#stage-containeriçerisindeki#app-viewport, ekran en-boy oranına göretransform: scale(...)ile bozulmadan, taşmadan ve bulanıklaşmadan ortalanır (letterbox / pillarbox).
Modüler ve Opsiyonel UI Kontrolleri (features)
Her içerikte tüm butonların olması zorunlu değildir. İhtiyaca göre konfigürasyondan true/false olarak yönetilir:
features: {
audio: true, // Ses açma/kapatma butonu & efektler
navigation: true, // İleri / Geri butonları
playButton: false, // Başlangıç kapak ekranı ve "Başla" butonu
score: true, // Skor / Puan rozeti
timer: true, // Süre sayacı
lives: true, // Can sistemi (❤️❤️❤️)
fullscreen: true, // Tam ekran butonu
progressBar: true // İlerleme çubuğu
},
initialLives: 3, // Başlangıç can sayısı (1-5)
timerMode: "stopwatch", // "stopwatch" (kronometre) veya "countdown" (geri sayım)
timerDuration: 60 // Geri sayım saniyesi🧠 Arka Plan Durum (State) & Telemetri API'si
Geliştiriciler veya AI ajanları içerik içinde doğrudan şu metodları çağırabilir:
shell.addScore(points): Puan ekler.shell.subtractScore(points): Puan düşürür.shell.loseLife(1): Bir can eksiltir. Canlar tükenince otomatik başarısızlık modalı açılır.shell.gainLife(1): Ekstra can verir.shell.startTimer("stopwatch" | "countdown", duration): Süreyi başlatır. Geri sayımda süre bitince "Süre Doldu" ekranı açılır.shell.getTelemetryData():{ score, elapsedSeconds, formattedTime, livesRemaining, isCompleted }nesnesini döndürür. SCORM veya harici LMS raporlama için hazırdır.
Dahili Ses Sentezleyici (Procedural Web Audio API)
Harici .mp3 dosyalarına ihtiyaç duymadan, tarayıcının yerel Web Audio API'si ile doğru, yanlış, buton tıklama ve bölüm sonu zafer fanfarı çalar.
SCORM 1.2 Desteği
imsmanifest.xmlpaketi hazırdır.core/scorm-api.jsaracılığıyla LMS mevcutsacmi.core.score.raw,cmi.core.lesson_statusverilerini otomatik iletir; LMS yoksa bağımsız (mock) modda sessizce çalışmaya devam eder.
Related MCP server: scorm-mcp-server
🚀 2. MCP (Model Context Protocol) Kurulumu ve Entegrasyonu
Bu MCP sunucusu; Antigravity IDE, Claude Desktop, Cursor veya herhangi bir MCP istemcisine bağlanabilir.
mcp_config.json veya claude_desktop_config.json Tanımı:
{
"mcpServers": {
"egiteknoloji-interactive": {
"command": "node",
"args": [
"d:\\wamp64\\www\\mcp\\etkilesimli-icerik\\mcp-server\\server.js"
]
}
}
}🛠️ 3. MCP Sunucusunun Sunduğu Yetenekler (Tools)
Tool Adı | Açıklama |
| 16:9 boyut kurallarını, Eğiteknoloji renk kodlarını, SCORM ve ses API'sini döndürür. |
| Desteklenen etkinlik türlerini ( |
| Yapay zeka ajanının ürettiği sorular/kavramlar ile sıfırdan çalışan, paketlenmiş 16:9 SCORM projesi oluşturur. |
💡 4. Yapay Zeka Ajanına Verilebilecek Örnek İstemler
MCP bağlandıktan sonra ajana şu şekilde komut verebilirsiniz:
"Bana 4. sınıf Fen Bilgisi 'Besinlerimiz ve Görevleri' konusu için 4 çiftli bir Eğiteknoloji eşleştirme oyunu hazırla. Ses olsun, süre sayacı olmasın, skor aktif olsun."
Ajan arka planda:
get_framework_specsile renk ve kuralları inceler.scaffold_interactive_activitytool'unu çağırarak içeriği tek seferde üretir.Çıktı olarak WAMP veya yerel klasörde doğrudan LMS'e yüklenebilecek SCORM hazır bir paket teslim eder.
📂 5. Klasör Hiyerarşisi
etkilesimli-icerik/
├── index.html # Canlı demo & etkinlik değiştirici (Eşleştirme + Quiz)
├── imsmanifest.xml # SCORM 1.2 manifest dosyası
├── logo_colorful_with_white_text.png
├── logo_icon_colorful.png
├── core/
│ ├── shell.css # Eğiteknoloji tasarım sistemi & 16:9 ölçekleyici stilleri
│ ├── shell.js # Shell yönetimi, timer, skor, navigasyon, responsive ölçekleyici
│ ├── audio-synth.js # Dahili Web Audio API ses motoru
│ └── scorm-api.js # SCORM 1.2 LMS wrapper & mock
├── activities/
│ ├── matching/ # 1. Örnek: Tıkla-Eşleştir (Click to Pair) Oyunu
│ │ ├── matching.css
│ │ └── matching.js
│ └── quiz/ # 2. Örnek: Çoktan Seçmeli Test Motoru
│ ├── quiz.css
│ └── quiz.js
└── mcp-server/ # MCP Sunucusu (Antigravity & AI Ajan Entegrasyonu)
├── package.json
└── server.js🖥️ 6. Canlı Önizleme
Tarayıcınızda doğrudan d:\wamp64\www\mcp\etkilesimli-icerik\index.html dosyasını açabilir veya WAMP sunucunuz aktifse http://localhost/mcp/etkilesimli-icerik/ adresinden test edebilirsiniz.
Available Tools
3 toolsget_framework_specsA
Eğiteknoloji 16:9 responsive arayüz standartlarını, kurumsal renk paletini, SCORM 1.2 kurallarını ve opsiyonel shell bayraklarını (ses, puan, butonlar vb.) getirir.
Inputs: no named parameters.
list_activity_templatesB
Hazır etkileşimli içerik şablonlarını (Eşleştirme, Çoktan Seçmeli Test vb.) ve veri yapılarını listeler.
Inputs: no named parameters.
scaffold_interactive_activityA
Belirtilen konfigürasyon ve veri setiyle (Quiz veya Eşleştirme) 16:9 oranlı, SCORM 1.2 uyumlu, Eğiteknoloji tasarımlı yeni bir etkileşimli içerik projesi oluşturur.
Inputs: data (required), title (required), activityType (required), outputDirectory (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct responsibility: fetching framework specs, listing available templates, and scaffolding a new activity. There is no meaningful overlap between them.
All tool names follow a consistent verb_noun snake_case pattern: get_, list_, scaffold_. The verbs clearly indicate the action and the nouns identify the resource.
Three tools is a focused, well-scoped set for a scaffolding-oriented MCP server. Each tool earns its place and none feels redundant.
The tool surface fully covers the core workflow: retrieve standards, inspect available templates, and generate a new interactive activity. There are no obvious dead ends for the server's stated purpose.
Maintenance
Related MCP Connectors
Create, edit, translate, and export SCORM eLearning modules from a connected AI assistant.
AI-powered LMS course builder: 89 tools, 17 skills, SCORM/xAPI export, agentic UI
Compiles structured specs into SCORM 1.2/2004 e-learning packages. 47 tools, quality gate, no LLM.
Create, edit and publish Educaplay educational games and quizzes from any AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceBuilds SCORM 2004 compliant e-learning courses locally with automated packaging and data privacy.1MIT
- AlicenseAqualityBmaintenancePackages self-contained HTML or Claude Design bundles into SCORM 2004 courses any LMS can import, with offline asset inlining, milestone-based completion/progress and score tracking. Fully local, no telemetry; validated end-to-end on SCORM Cloud.3374 npm6MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that compiles interactive, standards-conformant e-learning courses into SCORM packages. It lets you (or an AI client) describe a course as a structured spec and receive a self-contained SCORM zip ready for any LMS.9MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI models, educational applications, smart hardware, and teaching agents to interconnect and share data and context through a standardized protocol. Supports generating personalized stories, quizzes, and multimedia learning content, with age-appropriate filtering, multi-language output, and asynchronous task processing.-