Aerith Admin (RBAC Dashboard)

🚀 Aerith 教程サーバードキュメント

Aerith 教程サーバーは、モデル、コントローラー、レンダラーのアーキテクチャに基づくツールです。開発者がチュートリアル関連のタスクを管理および実行するのを支援することを目的としています。MANUS 方法（ある種のプロジェクト管理方法と仮定）を参考に、チュートリアルを具体的な手順とサブタスクに分解することで目標を達成します。

✨ 主な機能

• 指令管理：チュートリアル指令の作成、取得、管理が可能です。
• ワークフローステップ：タスク計画、情報収集、分析と編成、最終レポート生成などの機能を備えています。
• ブラウザ自動化：特定のブラウザ操作を自動実行して目標を達成できます。
• ファイルシステムツール：ディレクトリ構造の表示、ファイル内容の取得などの便利な機能を提供します。
• Git ツール統合：Git 操作（状態表示、ログ記録、ブランチ管理など）をサポートしています。

データストレージ

すべてのチュートリアル指令と関連データは JSON ファイルに保存され、.aerith/instructions ディレクトリに格納されます。

📦 インストール

プロジェクト構造

your-project/
├── .aerith/                  # Aerith 教程サーバーのデータとログを保存するディレクトリ
│   └── instructions/        # すべてのチュートリアル指令の JSON ファイルが含まれるディレクトリ
└── README.md                 # プロジェクトのドキュメントファイル

環境変数

• MCP_DEBUG=true：デバッグログを有効にします（開発環境ではデフォルトで設定されます）。
• 他の環境変数は必要に応じて設定できます。

💻 使用例

基本的な使用法

# サーバーを起動する
python3 -m aerith.server

# Web インターフェースにアクセスする
ブラウザを開き、http://localhost:8000 にアクセスする

主要ツール

指令管理

• create_instruction(title, description, goal, priority)：新しいチュートリアル指令を作成します。
• get_instruction(instruction_id)：指定された ID のチュートリアル指令を取得します。

ワークフローステップ

• create_task_plan(instruction_id, subtasks)：指令を具体的なサブタスクに分解します。
• gather_information(instruction_id, sources)：様々なソースから情報を収集します。
• analyze_and_orchestrate(instruction_id, analysis, execution_plan)：データを分析し、実行計画を策定します。
• execute_step(instruction_id, step_id, execution_details)：計画内の具体的なステップを実行します。
• generate_final_report(instruction_id, include_details)：詳細内容を含む最終レポートを生成します。

ブラウザ自動化

• run_browser_agent(goal)：特定の目標を達成するためにブラウザエージェントを実行します。

ファイルシステムツール

• tree_directory(directory_path, max_depth, show_files, show_hidden, pattern, exclude_common, custom_excludes)：指定されたディレクトリのツリー構造を表示します。Unix システムの tree コマンドに似ています。

Git ツール

• git_status(detailed)：作業ディレクトリの状態を表示します。
• git_log(count, show_stats, path, author, since, until)：コミットログを表示します。
• git_diff(file_path, staged, commit, compare_with)：指定されたファイルまたはコミット間の差分を表示します。
• git_branch(create, delete, remote, branch_name, base_branch)：ブランチを一覧表示、作成、または削除します。
• git_checkout(branch_name, create, force)：ブランチを切り替えるか、作業ディレクトリのファイルを復元します。
• git_commit(message, all_changes, amend)：リポジトリへの変更を記録します。
• git_push(remote, branch, force, tags)：リモート参照と関連オブジェクトを更新します。
• git_pull(remote, branch, rebase)：別のリポジトリから最新の変更を取得してマージします。
• git_add(paths)：ファイル内容をステージングエリアに追加します。

📚 ドキュメント

ファイルリソース

• file://{path}：パスを指定してファイル内容を取得します。
• project://structure：プロジェクト構造の辞書表現を取得します。

チュートリアルリソース

• instructions://list：すべてのチュートリアル指令のリストを取得します。

ログ記録

ログは .aerith/logs/mcp_server.log ファイルに保存され、標準エラー出力にも出力されます。MCP_DEBUG=true の場合（開発環境ではデフォルトで有効）、詳細なデバッグログが有効になります。

📄 ライセンス

MIT License