NeNe Records
MIT License · PHP 8.4 · MCP 対応

API ファーストな
柔軟エンティティ
プラットフォーム

NeNe Records は WordPress より軽く、より型安全なヘッドレス CMS です。
JSON API・OpenAPI・MCP ツールで、人も AI も同じデータを操作できます。

機能

本番運用に必要なものを、最初からすべて。

🗂️

型安全なエンティティ

text / int / bool / enum / datetime / image / file / markdown / relation — 9 種類の型付きフィールドで、WordPress のような非型付きメタデータから脱却。

📡

JSON API + OpenAPI

全操作を REST API として公開。OpenAPI 3.x 仕様書を同梱し、型安全なクライアント生成が可能。Problem Details (RFC 9457) で一貫したエラーレスポンス。

🤖

MCP 対応(60+ ツール)

Model Context Protocol に対応した 60 以上のツールで、AI エージェントがエンティティ CRUD・検索・エクスポートを自然言語で操作できる。

🎛️

管理 UI 内蔵

React + TypeScript の管理フロントエンドを内蔵。エンティティタイプ定義・フィールド管理・レコード編集・メディアライブラリ・ナビゲーション設定まで。

🔐

認証・権限管理

JWT Bearer 認証 + admin / editor ロール。CapabilityMiddleware で書き込み系エンドポイントを保護。公開 GET は認証不要。

🚀

ヘッドレス CMS として本番運用可能

予約公開・ドラフトプレビュー・Webhook・Export API (CSV/JSON)・全文検索・ETag キャッシュ・レート制限・スケジュール Cron — 運用に必要な機能を網羅。

はじめる

Docker があれば数分でローカル環境が動きます。

1. クローン

git clone https://github.com/hideyukiMORI/nene-records.git
cd nene-records

2. 環境変数を設定

cp .env.example .env
# .env を編集して DB パスワードなどを設定

3. 起動

docker compose up -d
docker compose exec app vendor/bin/phinx migrate
cd frontend && npm install && npm run dev

4. アクセス

管理画面: http://localhost:5173/admin

公開サイト: http://localhost:5173/

API: http://localhost:8082/api/v1/

技術スタック

PHP 8.4+ / バックエンド
NENE2 / フレームワーク
MySQL 8.4 / データベース
React + TypeScript / 管理 UI
OpenAPI 3.x / API 仕様
MCP / AI 連携
Docker / 開発環境
PHPUnit / テスト

今すぐ試してみる

MIT ライセンスのオープンソースプロジェクトです。
Issue・PR・フィードバック、いつでも歓迎します。

GitHub でスターをつける