Autonome MCP

🚀 autonome-mcp

RustベースのMCPサーバーで、macOS上でClaude Desktopに対して起動、ハートビート、連合タスク実行のエージェント機能を提供します。

✨ 主な機能

• AppleScriptを介してClaude Desktopに起動とハートビートメッセージを送信します。
• 設定可能な時間で定期的な起動/ハートビートを行うためのLaunchdインストーラーがあります。
• グレースフルなスキーマアップグレードをサポートするSQLiteステートストア（WAL）を使用しています。
• 検査用のstdout/stderr/exitアーティファクトを持つ連合タスクキューがあります。

🚀 クイックスタート

git clone <repo-url>
cd autonome-mcp
cargo build --release

サーバーを起動する

cargo run -- serve

MCPサーバーはClaude Desktop用に標準入出力を監視します。

スケジューリングを初期化する（macOS）

cargo run -- init --hour 1 --minute 0 --data-dir ~/.local/share/autonomy-mcp

autonomy.dbを作成し、毎日の起動用のLaunchd plistをインストールし、ハートビートのデフォルト設定を有効にします。

手動操作

• cargo run -- run-wake — 即時起動メッセージを送信します。
• cargo run -- run-heartbeat — 有効になっている場合、ハートビートを送信します。
• cargo run -- status — 永続化された状態とハートビート設定を表示します。
• cargo run -- test "MESSAGE" — デバッグ用の即席AppleScript送信を行います。

📚 ドキュメント

プロジェクトのレイアウト

• src/ — コアモジュール（applescript, federation, launchd, mcp, state, tasks, main.rs）。
• docs/ — 設計ノート（FEDERATION-TOOLS-SPEC.md）。
• scripts/ — ヘルパー自動化スクリプト（例：WakeClaude.applescript, build_trampoline.sh）。
• target/ — ビルド出力。

開発に関する情報

• コードフォーマット: cargo fmt
• リント: cargo clippy -- -D warnings
• テスト: cargo test
• リリースビルド: cargo build --release

コーディングスタイル: Rust 2021、アプリケーションフローにanyhow::Resultを使用し、ランタイムパスでunwrapを避け、コンテキスト豊富なフィールドを持つtracingを使用します。

🔧 技術詳細

データとセーフティに関する注意事項

• デフォルトのデータディレクトリ: ~/.local/share/autonomy-mcp/autonomy.db。テスト時には--data-dirで上書きできます。
• Launchd + AppleScriptはClaude DesktopがインストールされたmacOSを前提としています。サポートされていないホストでの実行は避けてください。
• トークンや個人情報をログに残さないでください。このプロジェクトはシークレットを埋め込まずに動作します。

コントリビュートに関する情報

コントリビューターガイドライン（構造、コマンド、スタイル、テスト、PRの期待事項）についてはAGENTS.mdを参照してください。