Myanmar MCP Server
🇲🇲 Myanmar MCP Server
Сервер Model Context Protocol (MCP) со встроенной системой анимации для приложений Мьянмы
✨ Возможности
Функция | Описание |
🤖 MCP Protocol | Полная реализация MCP SDK с транспортом stdio |
🎬 Система анимации | Анимационный движок на основе таймлайна с ключевыми кадрами и триггерами |
🔧 Расширяемые инструменты | Интеграция с GitHub, операции с файловой системой, пользовательские инструменты |
📦 TypeScript | Полная типобезопасность со строгим режимом |
🧪 Тестирование | Набор тестов Jest с отчетами о покрытии |
🐳 Docker | Готов к контейнерному развертыванию |
Related MCP server: Maya MCP
🚀 Быстрый старт
Установка
# 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Разработка
# Run with hot reload
npm run dev
# Run tests
npm test
# Lint code
npm run lint
# Format code
npm run format⚙️ Конфигурация
Создайте файл .env из примера:
cp .env.example .envПеременные окружения
Переменная | Описание | По умолчанию |
| Порт сервера |
|
| Хост сервера |
|
| Уровень логирования ( |
|
| Токен GitHub API | - |
| Включить систему анимации |
|
| Включить инструменты файловой системы |
|
| Включить инструменты GitHub |
|
🎬 Система анимации
Сердце Myanmar MCP Server — мощная система анимации на основе таймлайна.
Пример использования
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();Доступные пресеты
Пресет | Описание |
| Простое появление через прозрачность |
| Скольжение слева с затуханием |
| Прыгающее вертикальное движение |
| Пульсирующий эффект масштабирования |
| Вращение на 360° |
| Эффект печатной машинки |
| Волнообразное колебание |
Функции сглаживания
Функция | Сценарий использования |
| Постоянная скорость |
| Медленный старт, быстрое завершение |
| Быстрый старт, медленное завершение |
| Медленный старт и завершение |
| Эффект отскока |
| Пружинное движение |
Триггеры
{
"triggers": [
{ "type": "time", "time": 1000, "action": "onComplete" },
{ "type": "condition", "condition": "progress >= 0.5", "action": "onMidpoint" },
{ "type": "event", "event": "userClick", "action": "pauseAnimation" }
]
}Формат JSON анимации
{
"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": {}
}🛠️ Доступные инструменты
Инструмент GitHub
{
"action": "get_user",
"username": "amkyawdev"
}Действия: get_user, get_repo, list_repos, create_issue
Инструмент файловой системы
{
"action": "read_file",
"path": "/path/to/file.txt"
}Действия: read_file, write_file, list_dir, create_dir, delete
Инструмент анимации
{
"action": "run_script",
"script": "{ ... }",
"output": "console"
}Действия: 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Ручная сборка Docker
docker build -t myanmar-mcp-server .
docker run -p 3000:3000 --env-file .env myanmar-mcp-server📁 Структура проекта
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📊 Скрипты
Команда | Описание |
| Разработка с горячей перезагрузкой |
| Сборка для продакшена |
| Запуск продакшен-сборки |
| Запуск набора тестов |
| Запуск с отчетом о покрытии |
| Линтинг с ESLint |
| Автоисправление проблем линтинга |
| Форматирование с Prettier |
| Проверка типов TypeScript |
🧪 Тестирование
# Run all tests
npm test
# Watch mode
npm run test:watch
# Coverage report
npm run test:coverage👨💼 Администратор / Сопровождающий
Роль | Имя | GitHub |
Владелец и сопровождающий | Aung Myat Kyaw |
Обязанности
Ревью кода и одобрение слияний
Управление релизами
Обработка уязвимостей безопасности
Поддержка сообщества и обработка обращений
Контакты
GitHub Issues: для сообщений об ошибках и запросов функций
Email: (скоро)
🤝 Вклад в проект
Вклад приветствуется! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения рекомендаций.
Сделайте форк репозитория
Создайте ветку для вашей функции (
git checkout -b feature/amazing-feature)Зафиксируйте изменения (
git commit -m 'feat: add amazing feature')Отправьте изменения в ветку (
git push origin feature/amazing-feature)Откройте Pull Request
🔒 Безопасность
Если вы обнаружили уязвимость безопасности, сообщите о ней через:
GitHub Security Advisories — предпочтительный способ
Email — (скоро)
Пожалуйста, не раскрывайте проблемы безопасности публично, пока не будет доступно исправление.
📝 Лицензия
MIT © 2024 amkyawdev
Сделано с ❤️ для разработчиков Мьянмы
This server cannot be deployed
Maintenance
Related MCP Connectors
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Model Context Protocol server for todo.vu task management and time tracking.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA generic, modular server for implementing the Model Context Protocol (MCP).74 npm45ISC
- AlicenseBqualityBmaintenanceA 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.71192 PyPI25MIT

chuk-mcp-runtimeofficial
AlicenseNot gradedqualityCmaintenanceA robust runtime for the official Model Context Protocol (MCP) that adds proxying, session management, JWT auth, persistent user storage with scopes, and progress notifications.9Apache 2.0- AlicenseBqualityDmaintenanceA Model Context Protocol server integrating DevOps tools for GitHub, Docker, and filesystem operations.9MIT