Smithery: uma plataforma de registro de servidor MCP que conecta IA com ferramentas

Introdução geral

A Smithery é uma plataforma que ajuda os desenvolvedores a descobrir, implantar e gerenciar servidores MCP (Model Context Protocol), um protocolo aberto que permite que modelos de linguagem em larga escala (LLMs) se conectem perfeitamente a ferramentas e fontes de dados externas. que abrange uma ampla gama de funcionalidades, desde a pesquisa na Web até a automação de códigos. Os desenvolvedores podem integrar rapidamente esses servidores com ferramentas simples de linha de comando ou SDKs para ampliar os recursos de seus aplicativos de IA. Com suporte para implantação local e remota e foco em segurança e privacidade, a plataforma é ideal para a criação de assistentes de código inteligentes, interfaces de bate-papo ou fluxos de trabalho de IA personalizados. O objetivo da smithery é simplificar a integração da IA com ferramentas e acelerar o desenvolvimento da IA agêntica.

Lista de funções

• Registro e descoberta do servidor MCPMais de 4.000 servidores MCP estão disponíveis, para que os desenvolvedores possam navegar e escolher a ferramenta certa para o trabalho.
• Instrumentos de linha de comando (CLI)Comando: O comando pode ser usado com comandos simples (por exemplo smithery install) Instale e configure o servidor MCP.
• Suporte a SDKSDKs de TypeScript e Python estão disponíveis para simplificar a integração com modelos de linguagem.
• Implementação local e remotaSuporte para execução de servidores localmente ou hospedagem por meio da infraestrutura de nuvem da Smithery.
• gerenciamento de segurançaPrivacidade dos dados: garanta a privacidade dos dados usando variáveis de ambiente para armazenar informações confidenciais, como tokens de API.
• Compatibilidade com várias plataformasIntegração com ferramentas como Claude Desktop, Cursor e outras para oferecer suporte a uma ampla variedade de modelos de IA.
• Fluxos de trabalho automatizadosSuporte para tarefas complexas, como envio de códigos, consultas a bancos de dados e rastreamento da Web.
• Contribuições da comunidadePermite que os desenvolvedores ampliem o ecossistema enviando servidores MCP personalizados via GitHub.

Usando a Ajuda

Processo de instalação

A Smithery fornece um instrumento de linha de comando (CLI) para simplificar a instalação e a configuração do servidor MCP. Veja a seguir as etapas detalhadas da instalação:

1. Instalação da ferramenta CLI
   Certifique-se de ter o Node.js (versão 14 ou superior) instalado em seu sistema. Instale o Smithery CLI executando o seguinte comando em um terminal:

   npm install -g @smithery/cli
   

   Após a conclusão da instalação, execute smithery --version Verifique a versão para ter certeza de que a instalação foi bem-sucedida.

2. Navegação e seleção de servidores MCP
   entrevistas Site oficial da SmitheryPara visualizar a lista de servidores MCP, você pode filtrar por função (por exemplo, pesquisa na Web, gerenciamento de arquivos) ou por plataforma compatível (por exemplo, Claude, Cursor). Você pode filtrar por função (por exemplo, pesquisa na Web, gerenciamento de arquivos) ou por plataforma compatível (por exemplo, Claude, Cursor). Cada página de servidor exibe os comandos de instalação e as configurações necessárias.
3. Instalação do servidor MCP
   Como exemplo, vamos instalar o servidor GitHub MCP, supondo que você já tenha um GitHub Personal Access Token (PAT). Execute-o no terminal:

   smithery install --server=github.com/smithery-ai/mcp-github --token=$MY_GITHUB_PAT
   

   Aqui.$MY_GITHUB_PAT é o seu token do GitHub e recomenda-se que seja armazenado em uma variável de ambiente para aumentar a segurança. Depois de instalado, o servidor é executado localmente e é registrado automaticamente no seu cliente de IA (por exemplo, Claude Desktop).

4. Configuração do ambiente local
   Para implantações locais, a Smithery gera um arquivo de configuração (geralmente o arquivo smithery.yaml). Você pode definir o endereço do servidor, a porta e as informações de autenticação. Exemplo:

   server: github.com/smithery-ai/mcp-github
   port: 8080
   token: ${MY_GITHUB_PAT}
   

   Depois de salvar, execute smithery start Inicie o servidor.

5. Implementação remota (opcional)
   Se você escolher o serviço de hospedagem da Smithery, basta selecionar a guia "Hosted" (Hospedado) no painel do site oficial, inserir seu token e clicar em Deploy (Implantar). A Smithery executará automaticamente o servidor na nuvem, de modo que você não precisará configurá-lo localmente.

Funções principais

• Descoberta e integração do servidor MCP
  No site da Smithery, você pode pesquisar servidores MCP com recursos específicos. Por exemplo, digitar "web search" (pesquisa na Web) listará servidores como Brave Search, DuckDuckGo e outros. Clique nos detalhes do servidor para ver os modelos de IA compatíveis e as instruções de instalação.
  Para os desenvolvedores, a Smithery fornece o código de exemplo do SDK TypeScript. Por exemplo, conexão com o servidor de pesquisa Exa:

  import { MultiClient } from "@smithery/sdk";
  const client = new MultiClient();
  await client.connectAll({
  exa: createTransport("https://exa-mcp.example.com")
  });
  

  Depois de executar o código, seu modelo de IA pode realizar pesquisas na Web em tempo real com o Exa.

• Execução automatizada de tarefas
  O servidor MCP da Smithery oferece suporte a tarefas em várias etapas. Por exemplo, usando o servidor MCP do GitHub, uma IA pode criar arquivos automaticamente, fazer commit de código ou gerenciar repositórios. O processo é o seguinte:
  1. Insira uma tarefa como "Criar um arquivo README.md no meu repositório" em um cliente de IA, como o Claude Desktop.
  2. A IA chama o servidor GitHub MCP para executar a solicitação de API.
  3. O servidor retorna o resultado da operação e o AI exibe uma mensagem de confirmação.
     Esse processo elimina a necessidade de intervenção manual e melhora muito a eficiência.
• Gerenciamento de segurança e privacidade
  A Smithery enfatiza a segurança de tokens e dados. Recomenda-se armazenar informações confidenciais em variáveis de ambiente para evitar a entrada direta. Por exemplo, a configuração de um token do GitHub no Linux/Mac:

  export MY_GITHUB_PAT="your_token_here"
  

  Para servidores hospedados, a Smithery garante que os dados de configuração são "efêmeros" e não são armazenados por longos períodos de tempo. Os usuários devem verificar a política de privacidade de cada servidor para garantir a segurança dos dados. [](https://workos.com/blog/smithery-ai)

Operação da função em destaque

• Integração com o Claude Desktop
  A Smithery oferece integrações especializadas do Claude Desktop. Por exemplo, instale o servidor MCP da Obsidian para pesquisar as anotações da Obsidian:

  npx @smithery/cli install mcp-obsidian --client claude
  

  Depois de instalada, reinicie o Claude Desktop e a ferramenta MCP aparecerá automaticamente na interface. Você pode consultar o conteúdo de suas anotações em linguagem natural, por exemplo, "Find my 2025 project plan".

• Rastreamento e pesquisa na Web
  Usando o servidor Brave Search ou Perplexity MCP, a IA pode realizar pesquisas na Web em tempo real. Procedimento:
  1. Instale o servidor, por exemplo. smithery install --server=brave-search.
  2. Digite uma consulta no cliente de IA, como "Find the latest AI conferences" (Encontre as últimas conferências de IA).
  3. O servidor retorna resultados de pesquisa estruturados, que a IA agrupa e exibe.
• Contribuições da comunidade
  Os desenvolvedores podem enviar servidores MCP personalizados por meio do GitHub. As etapas são as seguintes:
  1. Escreva o código do servidor usando o SDK TypeScript ou Python da Smithery.
  2. estabelecer smithery.yaml arquivo de configuração que especifica os recursos e as dependências do servidor.
  3. Use a CLI para publicar:

     smithery publish --repo=your-github-repo
     

  Após o lançamento, o servidor aparecerá no Smithery Registry para usuários de todo o mundo. [](https://smitheryai.com/)

cenário do aplicativo

1. Assistente de código inteligente
   Os desenvolvedores usam os servidores GitHub ou Obsidian MCP da Smithery para permitir que a IA automatize o gerenciamento de repositórios de código ou pesquise notas de projeto. Isso é adequado para programadores que precisam localizar código ou documentação rapidamente.
2. Fluxos de trabalho automatizados
   As organizações podem automatizar tarefas orientadas por IA, como a geração de relatórios ou o gerenciamento de recursos em nuvem com o servidor MCP da Smithery, que integra consultas a bancos de dados ou operações de serviços em nuvem.
3. Educação e pesquisa
   Os pesquisadores usam servidores MCP para pesquisas na Web ou extração de dados para permitir que a IA colete e organize material acadêmico para acelerar a redação de artigos ou a análise de dados.
4. Produtividade pessoal
   Os usuários individuais podem melhorar sua eficiência diária, permitindo que a IA responda automaticamente a e-mails ou agende através dos servidores MCP do Gmail ou Calendar.

QA

1. Como o servidor MCP da Smithery é protegido?
   A Smithery recomenda o uso de variáveis de ambiente para armazenar tokens e evitar a inserção direta de informações confidenciais. Os dados de configuração dos servidores hospedados são armazenados temporariamente e não são retidos por longos períodos de tempo. Os usuários devem verificar a política de privacidade de cada servidor.
2. Há suporte para usuários não técnicos?
   Os usuários não técnicos podem selecionar e implementar servidores por meio da interface gráfica no site da Smithery, mas a CLI e o SDK são mais adequados para usuários com experiência em desenvolvimento.
3. Como faço para contribuir com servidores para a Smithery?
   Para bifurcar o repositório do servidor de referência da Smithery no GitHub, escrever o código e enviar uma solicitação pull, use o comando smithery publish Publique no Registro.
4. O Smithery é gratuito?
   A Smithery oferece uma CLI e um SDK gratuitos; alguns servidores hospedados podem exigir o pagamento de uma taxa.