Como implementar a adição de ferramentas personalizadas de gerenciamento de arquivos ao mcp-ui?

2025-08-25

1.8 K

Link diretoVisualização móvel

Guia estendido para ferramentas de gerenciamento de arquivos personalizados

A versão desktop do mcp-ui suporta a adição de ferramentas de manipulação de arquivos modificando o código de serviço do MCP da seguinte forma:

Definição dos parâmetros da ferramenta: emmcp_server.js(usado em uma expressão nominal)toolsNovos objetos são adicionados à matriz, por exemplo:
{ name: "file_manager", description: "本地文件管理器", parameters: { action: { type: "string", enum: ["read", "write", "list"] }, path: { type: "string" } } }
Implementação da lógica da ferramentano mesmo arquivo que ohandleToolCallpara adicionar código de processamento, usando a funçãofspara implementar operações de leitura e gravação, observe a adição do tratamento de erros.
Configuração de permissões (somente na versão desktop): no Electron'smain.jsConfiguração médianodeIntegration: truee declare as permissões de caminho de arquivo necessárias.

Casos de teste:
- Para ler o arquivo: digite "read. /notes.txt"
- Para listar diretórios: digite "list. /documents"

Recomendações de segurança:

Limite o intervalo de diretórios que podem ser acessados (por exemplo, somente a pasta de documentos do usuário).
Adiciona uma caixa de diálogo de confirmação para operações de gravação.
As operações confidenciais são registradas nomcp_operations.log.