Auralis Commander

🚀 Auralis Commander

Auralis Commander 是一款輕量級的 Windows MCP 服務器，以更少的資源實現更多功能。

🚀 快速開始

為什麼選擇 Auralis Commander？

我們開發 Auralis Commander 的原因是，現有的解決方案要麼過於臃腫，要麼功能受限：

Auralis Commander：擁有 14 個工具，涵蓋 shell、文件、搜索、進程和系統等方面，且不會造成臃腫。

✨ 主要特性

🎯 智能設計

一個 process_interactive 工具取代了 Desktop Commander 中的 5 個獨立工具：

• start_process → process_interactive { action: "start" }
• read_process_output → process_interactive { action: "read" }
• interact_with_process → process_interactive { action: "write" }
• force_terminate → process_interactive { action: "kill" }
• list_sessions → process_interactive { action: "list" }

📦 批量操作

一次調用即可讀取多個文件：

file_read { paths: ["config.json", "package.json", ".env"] }
// 一次性返回所有文件，錯誤不會阻塞其他文件的讀取

⚡ 原生 Windows 支持

針對 PowerShell 和 Windows 工作流進行了優化。無需 WSL，不依賴 Unix 假設。

🪶 輕量級

僅約 14KB 的核心代碼。啟動速度快，內存佔用少，上下文窗口使用量小。

工具對比

📦 安裝指南

選項 1：使用 npm（推薦）

npm install -g auralis-commander

選項 2：克隆並構建

git clone https://github.com/antonpme/auralis-commander
cd auralis-commander
npm install
npm run build

Claude Desktop 配置

將以下內容添加到 claude_desktop_config.json 中：

Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "auralis-commander": {
      "command": "node",
      "args": ["C:/path/to/auralis-commander/dist/index.js"]
    }
  }
}

重啟 Claude Desktop 以加載服務器。

📚 詳細文檔

工具參考

Shell 與系統

文件操作

目錄與搜索

💻 使用示例

運行開發服務器

// 啟動 Next.js 開發服務器
process_interactive { 
  action: "start", 
  command: "npm run dev", 
  cwd: "C:/projects/my-app" 
}
// → { session_id: "a1b2c3", output: "ready on http://localhost:3000", is_running: true }

// 檢查新輸出
process_interactive { action: "read", session_id: "a1b2c3", timeout_ms: 5000 }

// 完成後停止
process_interactive { action: "kill", session_id: "a1b2c3" }

交互式 Python REPL

process_interactive { action: "start", command: "python -u -i" }  // -u: 無緩衝，-i: 交互式
// → { session_id: "x1y2z3", output: "Python 3.12.0\n>>>", is_running: true }

process_interactive { action: "write", session_id: "x1y2z3", input: "2 + 2\n" }
// → { output: "4\n>>>", is_running: true }

process_interactive { action: "write", session_id: "x1y2z3", input: "exit()\n" }
// → { output: "", is_running: false }

批量配置檢查

file_read { 
  paths: [
    "package.json",
    "tsconfig.json", 
    ".env",
    ".env.local"
  ]
}
// 返回所有文件；缺失的文件會顯示錯誤，但不會阻塞其他文件

快速系統健康檢查

system_info {}
// → { cpu: { model, cores, usage }, memory: { total, used, free }, disks: [...], uptime: "3d 14h" }

processes { sort_by: "memory", limit: 10 }
// → 前 10 個內存佔用最多的進程

📚 配置說明

在主目錄中創建 auralis-commander.json 文件以設置默認值：

{
  "default_shell": "pwsh",
  "default_cwd": "C:/Projects",
  "max_file_read_mb": 50
}

🔧 技術細節

auralis-commander/
├── src/
│   ├── index.ts          # MCP 服務器設置和工具註冊
│   ├── config.ts         # 配置管理
│   ├── tools/
│   │   ├── shell.ts      # shell_exec
│   │   ├── files.ts      # file_* 和 dir_* 操作
│   │   ├── search.ts     # 內容和文件名搜索
│   │   ├── processes.ts  # 進程列表和終止
│   │   ├── system.ts     # 系統信息
│   │   └── interactive.ts # 交互式進程會話
│   └── utils/
│       ├── powershell.ts # PowerShell 執行包裝器
│       ├── paths.ts      # 路徑規範化
│       └── errors.ts     # 錯誤處理
├── dist/                 # 編譯後的 JavaScript
└── package.json

🤝 貢獻指南

歡迎提交問題和拉取請求。請遵循以下原則：

1. 保持工具功能專注，避免功能膨脹。
2. 保持 Windows 兼容性。
3. 在提交前使用 Claude Desktop 進行測試。

📄 許可證

本項目採用 MIT 許可證，你可以自由使用、修改和分發。