Skip to main content
Glama
amkyawdev
by amkyawdev

🇲🇲 Myanmar MCP Server

License: MIT TypeScript Node.js 18+

Un servidor de Model Context Protocol (MCP) con sistema de animación integrado para aplicaciones de Myanmar


✤ Características

Característica

Descripción

🤖 MCP Protocol

Implementación completa del SDK de MCP con transporte stdio

🎬 Sistema de Animación

Motor de animación basado en líneas de tiempo con fotogramas clave y disparadores

🔧 Herramientas Extensibles

Integración con GitHub, operaciones de sistema de archivos y herramientas personalizadas

📦 TypeScript

Seguridad total de tipos con modo estricto

🧪 Pruebas

Suite de pruebas de Jest con informes de cobertura

🐳 Docker

Despliegue contenedorizado listo


Related MCP server: Electron MCP Server

🚀 Inicio Rápido

Instalación

# Clone the repository
git clone https://github.com/amkyawdev/myanmar-mcp-server.git
cd myanmar-mcp-server

# Install dependencies
npm install

# Build for production
npm run build

Desarrollo

# Run with hot reload
npm run dev

# Run tests
npm test

# Lint code
npm run lint

# Format code
npm run format

⚙️ Configuración

Crea una archivo .env a partir del ejemplo:

cp .env.example .env

Variables de Entorno

Variable

Descripción

Valor por defecto

PORT

Puerto del servidor

3000

HOST

Host del servidor

localhost

LOG_LEVEL

Nivel de registro (debug, info, warn, error)

info

GITHUB_TOKEN

Token de la API impossibleIt

-

ENABLE_ANIMATION

Habilitar el sistema de animación

true

ENABLE_FILESYSTEM

Habilitar las herramientas de archivos del sitio

true

ENABLE_GITHUB

Habilitar las herramientas de GitHub

true


🎬 Sistema de Animación

El corazón de Myanmar MCP Server: un potente sistema de animación basado en líneas de tiempo.

Ejemplo de Uso

import { AnimationEngine, getPreset } from './animation';

// Load a preset
const engine = new AnimationEngine();
engine.load(getPreset('bounce'));
engine.play();

// Or load a custom script
engine.load({
  version: '1.0',
  name: 'My Animation',
  tracks: [{
    id: 'opacity',
    property: 'opacity',
    duration: 1000,
    keyframes: [
      { time: 0, value: 0 },
      { time: 1000, value: 1, easing: 'ease-out' }
    ]
  }]
});

engine.play();

Presets Disponibles

Preset

Descripción

fadeIn

Fundido de opacidad sencillo

slideInLeft

Deslizamiento desde la izquierda con fundido

bounce

Movimiento vertical con rebote

pulse

Efecto de pulso en escala

spin

Rotación de 360°

typewriter

Efecto de revelado de texto

wave

Oscilación ondulante

Funciones de Easing

Función

Caso de uso

linear

Velocidad constante

ease-in

Empieza lento, termina rápido

ease-out

Empieza rápido, termina lento

ease-in-out

Inicio y final lentos

bounce

Efecto de rebote

elastic

Movimiento similar al de un muelle

Disparadores

{
  "triggers": [
    { "type": "time", "time": 1000, "action": "onComplete" },
    { "type": "condition", "condition": "progress >= 0.5", "action": "onMidpoint" },
    { "type": "event", "event": "userClick", "action": "pauseAnimation" }
  ]
}

Formato JSON de Animación

{
  "version": "1.0",
  "name": "My Animation",
  "description": "Animation description",
  "tracks": [
    {
      "id": "unique-track-id",
      "property": "opacity",
      "duration": 2000,
      "keyframes": [
        { "time": 0, "value": 0 },
        { "time": 1000, "value": 1, "easing": "ease-out" }
      ]
    }
  ],
  "triggers": [],
  "metadata": {}
}

️ Herramientas Disponibles

Herramienta de GitHub

{
  "action": "get_user",
  "username": "amkyawdev"
}

Acciones: get_user, get_repo, list_repos, create_issue

Herramienta de Sistema de Archivos

{
  "action": "read_file",
  "path": "/path/to/file.txt"
}

Acciones: read_file, write_file, list_dir, create_dir, delete

Herramienta de Animación

{
  "action": "run_script",
  "script": "{ ... }",
  "output": "console"
}

Acciones: play, stop, pause, seek, get_state, list_presets, get_preset, run_script


🐳 Docker

# Build and run
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

Construcción Manual de Docker

docker build -t myanmar-mcp-server .
docker run -p 3000:3000 --env-file .env myanmar-mcp-server

📁 Estructura del Proyecto

myanmar-mcp-server/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server class
│   ├── tools/                # Tool implementations
│   │   ├── github.tool.ts
│   │   ├── filesystem.tool.ts
│   │   └── index.ts
│   ├── animation/            # Animation system ✨
│   │   ├── engine.ts         # Animation engine
│   │   ├── timeline.ts       # Timeline management
│   │   ├── keyframes.ts      # Keyframe interpolation
│   │   ├── interpolators.ts  # Easing functions
│   │   ├── triggers.ts       # Event triggers
│   │   ├── renderer.ts       # Output renderers
│   │   ├── presets.ts        # Built-in presets
│   │   └── types.ts          # Type definitions
│   ├── types/                # Shared types
│   ├── utils/                # Utilities
│   │   ├── logger.ts
│   │   └── config.ts
│   ├── middleware/            # Request middleware
│   ├── errors/                # Error classes
│   ├── validators/            # Zod schemas
│   └── services/              # Business logic
├── tests/                     # Test files
├── examples/                  # Animation examples
├── dist/                      # Build output
└── package.json

📊 Scripts

Comando

Descripción

npm run dev

Reeload en caliente para desarrollo

npm run build

Compila para producción

npm start

Ejecuta la compilación de producción

npm test

Ejecuta la imagen de pruebas

npm run test:coverage

Ejecutar con informe de cobertura

npm run lint

Lint con ESLint

npm run lint:fix

Corrige automáticamente problemas de linting

npm run format

Formatea con Prettier

npm run typecheck

Comprueba los tipos de TypeScript


🧪 Pruebas

# Run all tests
npm test

# Watch mode
npm run test:watch

# Coverage report
npm run test:coverage

👨💼 Admin / Mantenedor

Rol

Nombre

GitHub

Propietario y Mantenedor

Aung Myat Kyaw

@amkyawdev

Responsabilidades

  • Revisión de código y aprobación de merges

  • Gestión de versiones

  • Manejo de vulnerabilidades de seguridad

  • Soporte a la comunidad y clasificación de incidencias

Contacto

  • Issues de GitHub: Para informes de errores y solicitudes de funciones

  • Correo electrónico: (Próximamente)


🤝 Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUIR.md para las directrices.

  1. Haz un fork del repositorio

  2. Crea tu rama de funcionalidad (git checkout -b feature/amazing-feature)

  3. Realiza tus cambios (git commit -m 'feat: add amazing feature')

  4. Sube la rama al repositorio (git push origin feature/amazing-feature)

  5. Abre una Pull Request


🔒 Seguridad

Si descubres una vulnerabilidad de seguridad, repórtala mediante:

  1. GitHub Security Advisories — método preferido

  2. Correo electrónico — (Próximamente)

Por favor, no divulgues problemas de seguridad públicamente hasta que haya una corrección disponible.


📝 Licencia

MIT © 2024 amkyawdev


Hecho con ❤️ para los desarrolladores de Myanmar

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    B
    quality
    A
    maintenance
    A local Model Context Protocol server for controlling Autodesk Maya, providing typed tools for scene, modeling, animation, and more without Maya imports in the server process.
    71
    15
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A robust runtime for the official Model Context Protocol (MCP) that adds proxying, session management, JWT auth, persistent user storage with scopes, and progress notifications.
    9
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • MCP server for Mireye Earth — federal-source-cited geospatial data for any MCP-aware agent.

  • A Model Context Protocol server for Wix AI tools

View all MCP Connectors

Latest Blog Posts

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/amkyawdev/myanmar-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server