1 files changed, 38 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7d1d26c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# mml-composemusic-mcp
+
+MML (Music Macro Language) を使った作曲支援 MCP サーバー向け Python パッケージ。
+
+## 開発環境
+
+- Python 3.14+
+- 依存管理: [uv](https://docs.astral.sh/uv/)
+
+## セットアップ
+
+```bash
+uv sync
+```
+
+## 主要コマンド
+
+```bash
+# テスト実行
+uv run pytest
+
+# リンター・フォーマッタ実行
+uv run ruff check .
+uv run ruff format .
+
+# 依存追加
+uv add <package>
+
+# 開発依存追加
+uv add --dev <package>
+```
+
+## ディレクトリ構成
+
+```
+src/     # ソースコード
+tests/   # テストコード
+doc/     # ドキュメント
+\ No newline at end of file