What can you do with this server?

The mml-composemusic-mcp server lets you compose, validate, and generate retro chiptune-style music using MML (Music Macro Language) in NES-style 2A03 APU format. It supports two MML modes: ppmck (classic APU-style with A/B/T/N tracks) and pyxel (Pyxel-compatible with 0:–3: tracks). * Compose (action: compose): Parse MML source and synthesize it into a WAV audio file using retro square wave, triangle wave, and noise channels. Configure sample rate (default 44100 Hz) and toggle amplitude normalization. * Validate (action: validate): Check MML syntax for errors and warnings without generating audio. Returns a channel summary including note count, octave range, and duration ticks. * Generate templates (action: template): Get pre-built MML starting points in either format. Available templates: * basic – 4-channel layout (melody + chord + bass + rhythm) * melody – Melody-focused with minimal accompaniment * chord – Chord accompaniment focused * drum – Rhythm/beat focused using the Noise channel * empty – Channel headers only, blank slate

How do I use mml-composemusic-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mml-composemusic-mcp compose a short retro melody in pyxel format" 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.

mml-composemusic-mcp

by takashi000

Overview Schema Related Servers Score Discussions

Python

Hybrid

mml-composemusic-mcp

レトロチップ音源（2A03 APU）風のMMLをLLMに作曲させるためのMCPサーバです。

compose_mml という1つのツールで、MMLの作曲（WAV生成）、構文検証、テンプレート生成を行えます。

機能概要

機能	説明
`compose`	MMLを解析し、レトロAPU風の矩形波/三角波/ノイズでWAVファイルを生成する
`validate`	MMLの構文を検証し、エラー・警告・チャンネル概要を返す
`template`	`ppmck` / `pyxel` 用のテンプレートMMLを生成する

対応MML形式

モード	特徴
`ppmck`	PPMCKインスパイアのクラシックAPU準拠形式。小文字コマンド、`A`/`B`/`T`/`N` トラック
`pyxel`	Pyxel MML準拠形式。大文字コマンド、`0:`〜`3:` トラック、リピート・ゲートタイム対応

動作環境

Python 3.14 以上
uv（推奨）
依存パッケージ: fastmcp, numpy

インストール

1. リポジトリをクローンまたは配置

cd C:\\path\\to\\mml-composemusic-mcp

2. 依存関係をインストール

uv を使う場合:

uv sync

pip を使う場合:

pip install -e .

3. 起動確認

uv run mml-composemusic-mcp --help

以下のように表示されればOKです。

usage: mml-composemusic-mcp [-h] [--output-dir OUTPUT_DIR]
       [--transport {stdio,http,sse,streamable-http}] [--host HOST] [--port PORT]

MCPクライアントへの登録

Claude Desktop の場合

設定ファイルを開きます。
OS
パス
Windows
%APPDATA%\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers に以下を追加します。

{
  "mcpServers": {
    "mml-composemusic": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "C:\\path\\to\\mml-composemusic-mcp",
        "mml-composemusic-mcp",
        "--output-dir",
        "C:\\path\\to\\mml-composemusic-mcp\\data"
      ]
    }
  }
}

Claude Desktop を再起動します。

設定ファイル例

doc/mcp-client-config-example.json に設定例があります。必要に応じてコピーしてください。

トランスポートの選択

トランスポート	用途	設定方法
`stdio`	標準的なMCPクライアント接続（デフォルト）	`command`/`args` で指定
`http`	HTTPエンドポイント	`--transport http` で起動後、`url` で接続
`sse`	Server-Sent Events	`--transport sse` で起動後、`url` で接続
`streamable-http`	Streamable HTTP	`--transport streamable-http` で起動

SSEで使う場合の例

uv run mml-composemusic-mcp --transport sse --port 8080 --output-dir ./data

{
  "mcpServers": {
    "mml-composemusic": {
      "url": "http://127.0.0.1:8080/sse"
    }
  }
}

注意点

--output-dir は相対パスでも動きますが、MCPクライアントの作業ディレクトリが不定なため、絶対パスを推奨します。
初回起動時は uv が依存関係を解決するため、少し時間がかかることがあります。

ツールの使い方

ツール名

compose_mml

引数

引数名	型	必須	デフォルト	説明
`action`	string	yes	—	`compose`, `validate`, `template` のいずれか
`mml`	string	compose/validate時	`""`	MMLソース文字列
`mode`	string	compose/validate時	`""`	`ppmck` または `pyxel`
`template`	string	template時	`"basic"`	`basic`, `melody`, `chord`, `drum`, `empty`
`sample_rate`	integer	no	`44100`	出力WAVのサンプリングレート（Hz）
`normalize`	boolean	no	`true`	出力振幅を正規化するか

action=`compose` — WAVを生成

{
  "action": "compose",
  "mml": "0: T120 L8 O4 V100 @1\n   C D E F | G A B >C",
  "mode": "pyxel",
  "sample_rate": 44100,
  "normalize": true
}

戻り値

{
  "success": true,
  "wav_path": "./data/output_20260711_120000_123.wav",
  "duration_sec": 2.0,
  "note_sequence": { ... },
  "validation": {
    "errors": [],
    "warnings": []
  }
}

success が false の場合、wav_path は null になります。
エラーがある場合は validation.errors に詳細なエラー情報が入ります。
WAVファイル名は生成時刻ベースの output_YYYYMMDD_HHMMSS_mmm.wav 形式で出力されます。 毎回異なるファイル名になるため、複数回の compose 実行でファイルが上書きされることはありません。

action=`validate` — 構文チェック

{
  "action": "validate",
  "mml": "A t120 l8 o4 v15 q2\n  c d e f",
  "mode": "ppmck"
}

戻り値

{
  "valid": true,
  "errors": [],
  "warnings": [],
  "note_sequence": { ... },
  "channel_summary": [
    {
      "channel": "Pulse1",
      "note_count": 4,
      "octave_range": [4, 5],
      "duration_ticks": 768
    }
  ]
}

action=`template` — テンプレート生成

{
  "action": "template",
  "mode": "pyxel",
  "template": "basic"
}

戻り値

{
  "mml": "0: T120 L8 O4 V100 @1\n   C D E F | ...",
  "description": "基本的な4ch構成（メロディ+和音+ベース+リズム）"
}

テンプレート種別

テンプレート	内容
`basic`	基本的な4ch構成（メロディ+和音+ベース+リズム）
`melody`	メロディ重視（Pulse1主旋律、他は伴奏最小限）
`chord`	コード伴奏重視（Pulse2で和音、Triangleでベース）
`drum`	リズム重視（Noise中心のビートパターン）
`empty`	各チャンネルのヘッダーのみ（空のテンプレート）

MML形式

ppmck 形式の例

#TITLE "My Song"
#COMPOSER "LLM"

A t150 l8 o4 v15 q2
  c d e f | g a b > c

B l8 o3 v12 q1
  c r g r c r g r

T l4 o3 v7
  c2 c2 g2 g2

N l8 v10
  r c r c r c r c

pyxel 形式の例

0: T150 L8 O4 V100 @1
   C D E F G A B >C

1: L8 O3 V80 @2
   E G B R E G B R

2: L4 O3 V60
   C2 G2 E2 C2

3: L8 V80
   C R C R C R C R

詳細仕様

詳細なMMLコマンド仕様、IR構造、エラーコードは doc/Design.md を参照してください。

テスト・開発

テスト実行

uv run pytest

リント・フォーマット

uv run ruff check .
uv run ruff format .

手動でサーバを起動

uv run mml-composemusic-mcp --output-dir ./data

または:

uv run python -m mml_composemusic_mcp.server --output-dir ./data

ディレクトリ構成

.
├── doc/                          # 設計書・設定例
│   ├── Design.md                 # 統合設計書
│   ├── mcp.md                    # MCPツールスキーマ
│   └── mcp-client-config-example.json  # MCPクライアント設定例
├── src/mml_composemusic_mcp/     # ソースコード
│   ├── server.py                 # MCPサーバ
│   ├── lexer.py                  # MML字句解析
│   ├── parser_ppmck.py           # ppmckパーサ
│   ├── parser_pyxel.py           # pyxelパーサ
│   ├── parser_base.py            # パーサ共通処理
│   ├── ir.py                     # 中間表現・エラー型
│   ├── synthesizer.py            # APU風合成・WAV出力
│   └── templates.py              # テンプレート
├── tests/                        # テスト
├── README.md                     # このファイル
└── pyproject.toml                # プロジェクト設定

ライセンス

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

compose_mmlC

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/takashi000/mml-composemusic-mcp'

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

OS	パス
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`

mml-composemusic-mcp

目次

機能概要

対応MML形式

動作環境

インストール

1. リポジトリをクローンまたは配置

2. 依存関係をインストール

3. 起動確認

MCPクライアントへの登録

Claude Desktop の場合

設定ファイル例

トランスポートの選択

SSEで使う場合の例

注意点

ツールの使い方

ツール名

引数

action=compose — WAVを生成

戻り値

action=validate — 構文チェック

戻り値

action=template — テンプレート生成

戻り値

テンプレート種別

MML形式

ppmck 形式の例

pyxel 形式の例

詳細仕様

テスト・開発

テスト実行

リント・フォーマット

手動でサーバを起動

ディレクトリ構成

ライセンス

Maintenance

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

action=`compose` — WAVを生成

action=`validate` — 構文チェック

action=`template` — テンプレート生成