金大哥 - auralis-commander MCP 详情

article

README

🚀 Auralis Commander

Auralis Commander 是一款轻量级的 Windows MCP 服务器，以更少的资源实现更多功能。

🚀 快速开始

为什么选择 Auralis Commander？

我们开发 Auralis Commander 的原因是，现有的解决方案要么过于臃肿，要么功能受限：

| MCP 服务器 | 工具数量 | 重点功能 | 存在问题 | |------------|-------|-------|---------| | Desktop Commander | 26 | 涵盖所有方面 | 过于臃肿，仅处理进程就需要 5 个工具 | | Filesystem (Anthropic) | 11 | 仅处理文件 | 没有 shell 功能，无法处理进程，也没有系统信息 | | Windows CLI | 8 | PowerShell | 无法进行文件操作，功能范围有限 |

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 的核心代码。启动速度快，内存占用少，上下文窗口使用量小。

工具对比

| 功能 | Auralis | Desktop Commander | Filesystem | Windows CLI | |------------|:-------:|:-----------------:|:----------:|:-----------:| | Shell 执行 | ✅ | ✅ | ❌ | ✅ | | 文件读写 | ✅ | ✅ | ✅ | ❌ | | 文件搜索 | ✅ | ✅ | ✅ | ❌ | | 批量文件读取 | ✅ | ✅ | ✅ | ❌ | | 交互式进程 | ✅ | ✅ | ❌ | ❌ | | 进程管理 | ✅ | ✅ | ❌ | ❌ | | 系统信息 | ✅ | ✅ | ❌ | ✅ | | 查找与替换 | ✅ | ✅ | ✅ | ❌ | | 工具总数 | 14 | 26 | 11 | 8 | | 上下文开销 | 低 | 高 | 低 | 低 |

📦 安装指南

选项 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 与系统

| 工具 | 描述 | |------|-------------| | shell_exec | 在 pwsh、powershell 或 cmd 中执行命令 | | system_info | 获取 CPU、内存、磁盘使用情况和系统运行时间 | | processes | 列出正在运行的进程及其内存/CPU 统计信息 | | process_kill | 根据 PID 或名称终止进程 | | process_interactive | 运行并与长时间运行的进程进行交互 |

文件操作

| 工具 | 描述 | |------|-------------| | file_read | 使用 paths 数组读取单个文件或批量文件 | | file_write | 写入或追加到文件，自动创建目录 | | file_edit | 在文件中查找并替换文本 | | file_delete | 删除文件或目录（使用 recursive 标志） | | file_move | 移动或重命名文件和目录 | | file_info | 获取文件元数据：大小、日期、行数、权限 |

目录与搜索

| 工具 | 描述 | |------|-------------| | dir_list | 列出目录内容，支持深度控制和通配符模式 | | dir_create | 创建目录及其父目录 | | search | 根据文件名或内容进行搜索，并支持过滤 |

💻 使用示例

运行开发服务器

// 启动 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
}

| 选项 | 默认值 | 描述 | |--------|---------|-------------| | default_shell | pwsh | 命令使用的 shell：pwsh、powershell 或 cmd | | default_cwd | 主目录 | 默认工作目录 | | max_file_read_mb | 50 | 读取文件的最大大小（MB） |

🔧 技术细节

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

🤝 贡献指南

欢迎提交问题和拉取请求。请遵循以下原则：

保持工具功能专注，避免功能膨胀。
保持 Windows 兼容性。
在提交前使用 Claude Desktop 进行测试。

📄 许可证

本项目采用 MIT 许可证，你可以自由使用、修改和分发。

auralis-commander