Aerith Admin MCP Server

Aerith 管理者 MCP サーバー

Aerith Admin MCP（モデル、コントローラー、プレゼンター）サーバーは、ブラウザ自動化機能を備えたRBACダッシュボードアプリケーション向けに、MANUSに着想を得た開発ワークフローを実装しています。このサーバーはローカルで実行され、Cursor IDEのMCP統合を介してアクセスするように設計されています。

概要

このサーバーは、5 つのステップのワークフローを通じて構造化された開発アプローチを提供します。

1. USER_INSTRUCTION - 明確な目標を持つ開発タスクを定義する
2. TASK_PLANNING - タスクを特定のサブタスクに分割する
3. 情報収集- さまざまな情報源から関連情報を収集する
4. ANALYSIS_AND_ORCHESTRATION - 情報を分析し、実行計画を作成する
5. RESULT_SYNTHESIS - ステップを実行し、包括的なレポートを生成する

インストール

使用法

サーバーは次の 2 つのモードで実行できます。

HTTP モード (デフォルト)

これにより、ポート8090（または別のポート番号）でサーバーが起動します。サーバーは、リアルタイム更新のためのREST APIとServer-Sent Events（SSE）を提供します。

STDIOモード

このモードは、JSON-RPC プロトコルを使用して標準入出力を介して通信し、他のツールと統合するように設計されています。

レジリエントモード

実稼働または拡張開発セッションでは、サーバーを復元モードで実行できます。復元モードでは、サーバーの健全性が自動的に監視され、クラッシュした場合に再起動されます。

回復力のあるモードには次のものが含まれます。

• 継続的な健康モニタリング
• クラッシュ時の自動再起動
• 正常なシャットダウン処理
• ハートビート検出とログ記録

監視

監視スクリプトを使用して、手動でサーバーの健全性を確認したり、再起動したりすることができます。

カーソルIDE統合

このMCPサーバーは、Cursor IDEと連携するように特別に設計されています。Cursorはサーバーに接続して、エディターから直接その機能を利用できます。

カーソル統合の設定:

1. MCP サーバーが HTTP モードで実行されていることを確認します: python server.py --port 8090
2. Cursor は、 .cursor/mcp.json構成を使用して MCP サーバーを自動的に検出します。
   { "mcpServers": { "aerith-admin-mcp": { "url": "http://localhost:8090/sse" } } }
3. Cursor IDEでAerith Adminプロジェクトを開きます。
4. カーソルMCP統合UIを使用してサーバーと対話します

プロジェクト構造

開発セットアップ

このプロジェクトでは、開発に専用の仮想環境を使用します。

テスト

テストは pytest を使用して記述され、 tests/ディレクトリに配置されます。

テストの実行

提供されているスクリプトを使用してテストを実行します。

環境変数

• MCP_DEBUG=true - デバッグログを有効にする（activate_venv.shによって自動的に設定される）
• 必要に応じて追加の環境変数を設定できます

APIドキュメント

ツール

サーバーは次のツールを提供します。

指導管理

• create_instruction(title, description, goal, priority) - 新しい開発指示書を作成する
• get_instruction(instruction_id) - 既存の命令を取得する
• build_feature(title, description, goal, priority) - 完全な機能を構築するための高レベルのオーケストレーション

ワークフローの手順

• 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/instructionsディレクトリ内の JSON ファイルに保存されます。

ログ記録

ログは.aerith/logs/mcp_server.logに保存され、stderrにも出力されます。MCP_DEBUG MCP_DEBUG=true （開発環境ではデフォルト）に設定すると、詳細なデバッグログが有効になります。

ライセンス

MITライセンス