Desktop Extensions (DXT): ferramenta de empacotamento para simplificar a instalação do servidor MCP local

O Desktop Extensions (DXT) é uma ferramenta desenvolvida pela Anthropic para empacotar servidores MCP (Model Context Protocol) nativos em um pacote fácil de instalar.dxtO DXT está disponível em um formato compactado ZIP que contém todos os arquivos do servidor MCP e um arquivo de configuração complexo. Ele permite que os desenvolvedores integrem rapidamente o servidor MCP aos aplicativos de desktop, e os usuários podem instalá-lo com um único clique, sem configurações complexas. O DXT vem em um formato compactado ZIP e contém todos os arquivos do servidor MCP e ummanifest.jsonA Anthropic incentiva os desenvolvedores a participarem dos aprimoramentos por meio do código aberto da especificação e da cadeia de ferramentas do DXT para promover a popularidade das ferramentas de IA para aplicativos de desktop. O DXT é compatível com aplicativos como o Claude Desktop e oferece recursos como atualizações automáticas e configuração simples, reduzindo a barreira de uso para desenvolvedores e usuários corporativos.

Lista de funções

• Instalação do servidor MCP com um cliqueOs usuários podem acessar o site clicando no link.dxtpara instalar o servidor MCP local, sem necessidade de configurar manualmente o ambiente.
• Geração de arquivos de extensãoFerramentas de CLI: fornece ferramentas de CLI que permitem aos desenvolvedores criar e empacotar com comandos simples.dxtDocumentação ampliada.
• Suporte a vários ambientes operacionaisCompatível com Node.js, Python e outros tempos de execução, compatível com as plataformas macOS, Windows e Linux.
• Mecanismo de autenticação seguraSegurança operacional: garanta a segurança operacional verificando a integridade estendida por meio de hashing criptográfico.
• Função de atualização automáticaSuporte a atualizações automáticas estendidas para manter o servidor atualizado.
• Gerenciamento da configuração do usuário: através demanifest.jsonDefina os itens de configuração do usuário, como chaves de API, direitos de acesso ao diretório, etc.
• Suporte ecológico abertoDXT: especificação de código aberto e cadeia de ferramentas que permite que os desenvolvedores personalizem e ampliem o formato DXT.
• Tratamento de erros e registro em logForneça alertas de erro claros e registros de depuração para que os desenvolvedores possam solucionar problemas.

Usando a Ajuda

Processo de instalação

Para usar o DXT, os desenvolvedores precisam instalar a ferramenta DXT CLI e, em seguida, criar e empacotar a extensão. Veja a seguir as etapas detalhadas:

1. Instalação do Node.js
   A CLI do DXT depende do ambiente do Node.js. Visite o site do Node.js para fazer download e instalar a versão mais recente (recomendamos o Node.js >= 16.0.0).
2. Instalação da CLI do DXT
   Abra um terminal e execute o seguinte comando para instalar globalmente a ferramenta DXT CLI:

   npm install -g @anthropic-ai/dxt
   

3. Criação de extensões DXT
   • Crie uma pasta de projeto localmente, por exemplomy-extension.
   • Vá para a pasta e execute o seguinte comando para inicializar a extensão:

     dxt init my-extension
     

     O sistema solicita o nome da extensão, as informações do autor e a ID da extensão se a pasta tiver umpackage.jsonSe o usuário não tiver acesso às informações, algumas delas serão preenchidas automaticamente. Quando terminar, geremanifest.jsonDocumentação.

4. Configuração do manifest.json
   manifest.jsoné o arquivo principal da extensão DXT que define os metadados da extensão e a configuração do servidor. Veja a seguir um exemplo:

   {
   "dxt_version": "0.1",
   "name": "My MCP Extension",
   "version": "1.0.0",
   "description": "一个简单的MCP服务器扩展",
   "server": {
   "type": "node",
   "entry_point": "server/index.js",
   "mcp_config": {
   "command": "node",
   "args": ["server/index.js"]
   }
   },
   "user_config": {
   "allowed_directories": {
   "type": "directory",
   "title": "允许访问的目录",
   "multiple": true,
   "required": true,
   "default": ["${HOME}/Desktop"]
   }
   }
   }
   

   • Descrição do campo::
     • dxt_versionDXT: A versão da especificação DXT que a extensão segue.
     • nameresponder cantandoversionNome e número da versão da extensão: O nome e o número da versão da extensão.
     • serverDefinir como o servidor MCP é executado, por exemplo, usando Node.js para executarserver/index.js.
     • user_configDefinem itens configuráveis pelo usuário, como diretórios que podem ser acessados.
5. Escrevendo código de servidor MCP
   existirserverCrie uma pasta no diretórioindex.jsque implementa a lógica do servidor MCP. A lógica do servidor MCP pode ser implementada usando o@modelcontextprotocol/sdkManipulação da comunicação com modelos de IA. Um exemplo simples é mostrado abaixo:

   const { MCP } = require('@modelcontextprotocol/sdk');
   const server = new MCP();
   server.registerTool({
   name: 'search_files',
   description: '搜索指定目录中的文件',
   execute: async (params) => {
   // 实现文件搜索逻辑
   return { result: '文件列表' };
   }
   });
   server.start();
   

6. Extensão da embalagem
   Depois de concluir o código e a configuração, execute o seguinte comando para empacotar o projeto como.dxtDocumentação:

   dxt pack my-extension my-extension.dxt
   

   embalado.dxtO arquivo é um arquivo ZIP que contém todos os arquivos e dependências.

7. Verificação e assinatura
   • Verifique a extensão: executedxt verify my-extension.dxtVerificação da integridade do documento.
   • Extensão da assinatura (opcional): rundxt sign my-extension.dxtAdicione assinaturas às extensões para aumentar a segurança.
8. Instalação no Claude Desktop
   • Certifique-se de que o Claude Desktop esteja atualizado para a versão mais recente (a versão compatível com DXT).
   • Abra as configurações do Claude Desktop e localize a seção "Extensões".
   • Clique em "Install Extension" (Instalar extensão) e selecione.dxtpara concluir a instalação com um clique.

Funções principais

• Criação de extensões: Usodxt initComando para geração rápidamanifest.jsone siga os prompts para configurar as informações estendidas.
• Extensões de validação: Executardxt validate manifest.jsonVerifique se o arquivo de configuração está em conformidade com a especificação DXT.
• Executando o servidor MCPApós a instalação da extensão, o Claude Desktop a usará para criar uma nova extensão com base nomanifest.jsonacertou em cheioserverConfiguração para iniciar o servidor MCP local. Os usuários podem definir chaves de API ou permissões de diretório por meio da interface.
• Depuração e registro em logO servidor MCP gera logs quando é executado, e os desenvolvedores podem verificar os logs em busca de chamadas de ferramentas ou mensagens de erro.
• Suporte a ferramentas dinâmicasDXT: O DXT oferece suporte ao registro dinâmico de ferramentas, como pesquisas de arquivos ou chamadas de API, que os desenvolvedores precisam registrar nomanifest.jsonDefina o nome da ferramenta e os parâmetros na seção

advertência

• seguromanifest.jsonno caminho (por exemploserver/index.js) é consistente com a estrutura real do documento.
• O empacotamento deve incluir todas as dependências (node_modules) para garantir que a extensão funcione corretamente em diferentes ambientes.
• Os usuários corporativos podem consultar a documentação do Anthropic Enterprise para implantar as extensões DXT.

cenário do aplicativo

1. Distribuição rápida de servidores MCP pelos desenvolvedores
   Os desenvolvedores podem empacotar servidores MCP complexos como.dxtque é compartilhado com o usuário, e o usuário não precisa configurar o ambiente para usá-lo.
2. Integração empresarial de ferramentas de IA
   As empresas podem desenvolver extensões DXT personalizadas que se integram aos fluxos de trabalho internos de IA, como análise de dados ou tarefas de automação.
3. Educação e pesquisa
   Os pesquisadores podem usar o DXT para criar servidores MCP experimentais para testar modelos de IA que interagem com dados locais.
4. Ferramentas de produtividade pessoal
   Os usuários podem instalar a extensão DXT no Claude Desktop para chamar rapidamente a pesquisa de arquivos, a geração de códigos e outras funções para aumentar a eficiência do trabalho.

QA

1. Como as extensões DXT são protegidas?
   O DXT verifica a integridade estendida por meio de hashing criptográfico para evitar adulterações. O tempo de execução usa um ambiente isolado com acesso restrito ao servidor.
2. Quais plataformas são compatíveis com o DXT?
   O DXT é compatível com macOS, Windows e Linux e oferece suporte aos tempos de execução do Node.js e do Python.
3. Como depurar as extensões DXT?
   Verifique o arquivo de registro ou use o comandodxt info my-extension.dxtRevise as informações da extensão para garantir que a configuração e o código estejam corretos.
4. Preciso atualizar a extensão manualmente?
   O DXT é compatível com atualizações automáticas, portanto, os usuários não precisam reinstalar manualmente.
5. O DXT funciona em aplicativos que não sejam da Claude?
   Sim, o DXT é um formato de código aberto e outros aplicativos de desktop compatíveis com MCP podem integrar o DXT.