Autonome MCP

🚀 autonome-mcp

autonome-mcp 是一個基於 Rust 的 MCP 服務器，它使 Claude Desktop 能夠在 macOS 系統上進行喚醒、心跳監測以及聯合任務執行等操作。

🚀 快速開始

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 配置文件以實現每日喚醒功能，並啟用默認的心跳監測。

手動操作

• cargo run -- run-wake — 立即發送喚醒消息。
• cargo run -- run-heartbeat — 若已啟用，則發送心跳消息。
• cargo run -- status — 顯示持久化狀態和心跳配置。
• cargo run -- test "MESSAGE" — 用於調試的臨時 AppleScript 發送命令。

✨ 主要特性

• 通過 AppleScript 向 Claude Desktop 發送喚醒和心跳消息。
• 提供 Launchd 安裝程序，可按配置的時間進行定時喚醒和心跳監測。
• 採用 SQLite 狀態存儲（WAL），支持優雅的模式升級。
• 具備聯合任務隊列，可查看標準輸出、標準錯誤輸出和退出信息。

📚 詳細文檔

項目結構

• 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。