Skip to main content
Glama
deenesjakoruzh
amkyawdev

Myanmar MCP Server

by amkyawdev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

🇲🇲 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: Maya MCP

🚀 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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers