Claude Dev Tools

🚀 用於Claude桌面的應用服務器：Claude Desktop Commander MCP

本項目是一個允許Claude桌面應用程序在您的計算機上執行長時間運行的終端命令並通過Model Context Protocol (MCP) 管理進程的服務器。它構建於MCP文件系統服務器之上，以提供額外的搜索和替換文件編輯功能。

🚀 快速開始

本服務器主要有兩個關鍵點：終端命令和基於差異的文件編輯。它能讓Claude桌面應用在本地計算機執行長時間運行的終端命令，並通過MCP管理進程。

✨ 主要特性

• 執行帶有輸出流式傳輸的終端命令
• 長時間運行命令的超時設置
• 進程管理：啟動、停止、重啟
• 文件操作：讀取、寫入、刪除
• 支持基於差異的代碼塊文件編輯

📦 安裝指南

方法一：使用smithery CLI安裝

1. 打開終端。
2. 運行以下命令：

smith install @wonderwhy-er/desktop-commander

方法二：手動安裝

1. 克隆此倉庫：

git clone https://github.com/wonderwhy-er/ClaudeDesktopCommander.git
cd ClaudeDesktopCommander

2. 安裝依賴項：

npm install

3. 啟動服務器：

npm start

方法三：通過npx安裝

直接運行以下命令：

npx -y @wonderwhy-er/desktop-commander setup

手動配置

1. 創建或編輯 claude_desktop_config.json 文件。
2. 添加以下內容：

{
  "command": {
    "timeout": 3600, // 超時時間，單位秒，默認3600秒（1小時）
    "streamOutput": true // 是否流式輸出，默認true
  },
  "file": {
    "root": "/path/to/files" // 文件操作根目錄，默認當前工作目錄
  }
}

💻 使用示例

基本用法

# 執行單行命令
execute_command("ls -a")

# 後臺執行長時間運行的任務
execute_commandInBackground("long_task.sh", (status, output) => {
  console.log(`任務完成，狀態：${status}, 輸出：${output}`);
})

# 監視文件變化
watchFile("/path/to/file.txt", (event, filename) => {
  console.log(`檢測到文件變化：${filename}`)
})

高級用法

進程管理

startProcess("app_process")
restartProcess("app_process")
stopProcess("app_process")

文件操作

readFile("/path/to/file.txt", (err, content) => {
  if (err) throw err;
  console.log(content);
})

writeFile("/path/to/newfile.txt", "寫入內容", (err) => {
  if (err) throw err;
  console.log("文件寫入成功");
})

基於差異的代碼編輯

// 在Claude中定義一個差異塊：
diff_block = """\
- 刪除的部分
+ 新增的內容
@@ -1,5 +1,6 @@
 這是修改後的代碼"""

applyDiff("/path/to/file.txt", diff_block, (err) => {
  if (err) throw err;
  console.log("文件已成功更新");
})

🤝 貢獻

如果您覺得這個項目有用，請考慮在GitHub上給它點個星！這將幫助更多人發現此項目並鼓勵進一步開發。

我們歡迎社區的貢獻！無論您發現了錯誤，有功能需求，還是想提交代碼，以下是如何參與的方式：

• 發現問題？ 在github.com/wonderwhy-er/ClaudeDesktopCommander/issues上打開一個問題。
• 有功能想法？ 提交一個功能請求到問題部分。
• 想貢獻代碼？ 叉取倉庫，創建分支，並提交拉取請求。
• 有問題或討論？ 在GitHub Discussions部分開始討論。

所有的貢獻，無論大小，都受到極大的歡迎！

📄 許可證

MIT