convez.ai
MCP ServerAutomaçãoIntermediário
liheng-personal

Finder MCP Server

liheng-personal/finder-mcp-server

Controle seguro do Finder via Claude com AppleScript hardcoded

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server seguro para integração com Finder do macOS, expondo operações de arquivo e pastas através de ferramentas nomeadas. Implementa design defensivo com zero entrada de scripts, apenas parâmetros estruturados, eliminando vetores de injeção.

Instalação

$npx convez-ai liheng-personal/finder-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Listar e navegar estrutura de pastas do macOS via Claude
  • Obter metadados de arquivos e pastas automaticamente
  • Automatizar operações de arquivo (criar pastas, renomear, mover para lixo)
  • Revelar e abrir arquivos no Finder a partir de contexto de conversa

Veredito

Implementação técnicamente sólida com design defensivo admirável (zero shell script injection, AppleScript hardcoded). Bem-vindo para usuários macOS que precisam integração segura com sistema de arquivos; documentação clara e modelo de ferramentas bem estruturado.

README

A tradução para o português deste README ainda está na fila.

finder-mcp-server

針對 Finder 的獨立 MCP server。只暴露具名工具,不接受任意 script 輸入,徹底沒有 do shell script 入口。

安全設計

  • 零 script 輸入:所有 AppleScript 都是程式碼裡的硬編碼字面量,Claude 傳進來的只有參數值(路徑、名稱)
  • 沒有 do shell script:整個 codebase 沒有這個呼叫
  • 單一執行路徑:只有 runAppleScript() 這一個函式會呼叫 osascript,所有工具都經過它

工具清單

工具說明破壞性
finder_list_folder列出資料夾內容否
finder_get_selection取得目前選取的項目否
finder_get_info取得檔案/資料夾的 metadata否
finder_open_folder在 Finder 開啟資料夾否
finder_reveal在 Finder 中高亮顯示項目否
finder_create_folder建立新資料夾否
finder_rename重新命名檔案或資料夾否
finder_move_to_trash移至垃圾桶(可還原)是

安裝

# 需求:Node.js >= 18
cd finder-mcp-server
npm install
npm run build

設定 MCP Client

在你的 claude_desktop_config.json(或 mcp.json)加入:

{
  "mcpServers": {
    "finder": {
      "command": "node",
      "args": ["/絕對路徑/finder-mcp-server/dist/index.js"]
    }
  }
}

路徑改成你實際 clone 的位置。

macOS 權限

System Settings → Privacy & Security → Automation

找到跑這個 server 的 app(通常是 Terminal 或 Claude Desktop),確認 Finder 的 checkbox 有勾。

擴充工具

在 src/index.ts 加新的 server.registerTool(...) block。 所有 AppleScript 都寫在工具內部,不要加任何接受 script 字串的參數。

Ver o original no GitHub

Bom para

Relacionados