O ToolSDK.ai é um kit de desenvolvimento de software (SDK) TypeScript gratuito para desenvolvedores com foco na conexão e no gerenciamento de servidores MCP (Model Context Protocol) com ferramentas de IA. Seu principal objetivo é simplificar a complexidade da integração de vários servidores MCP para desenvolvedores no desenvolvimento de aplicativos de IA. Com uma única linha de código, os usuários podem acessar rapidamente mais de 5.000 servidores MCP e 10.000 ferramentas de IA para criar agentes de IA eficientes ou fluxos de trabalho automatizados. O toolSDK.ai é compatível com as principais estruturas, como Next.js e React, o que o torna ideal para o desenvolvimento rápido de aplicativos orientados por IA. Sua abertura permite que os desenvolvedores adicionem servidores MCP personalizados por meio de repositórios do GitHub para aumentar a flexibilidade.
Lista de funções
- Fornece um SDK TypeScript que suporta o acesso de uma linha de código a mais de 5.000 servidores MCP e mais de 10.000 ferramentas de IA.
- Oferece suporte à integração perfeita com o OpenAI SDK e o Vercel AI SDK para simplificar o processo de desenvolvimento.
- Permite que os desenvolvedores adicionem e registrem servidores MCP personalizados por meio de repositórios do GitHub.
- Suporte para a criação de aplicativos de fluxo de trabalho automatizados, como Zapier, n8n.
- Fornece recursos de desenvolvimento de agentes de IA para criar rapidamente inteligências que podem lidar com tarefas complexas.
- Compatível com as principais estruturas, como React, Next.js, Svelte e Node.js.
- Fornece arquivos de configuração JSON estruturados, gera automaticamente pacotes README e npm.
Usando a Ajuda
Processo de instalação
O ToolSDK.ai é um kit de ferramentas baseado em TypeScript que requer um ambiente de desenvolvimento básico para ser instalado e usado. Veja a seguir as etapas detalhadas de instalação:
- Preparação do ambiente de desenvolvimento
Certifique-se de ter o Node.js 18+ e o gerenciador de pacotes pnpm instalados em seu computador. O node.js fornece o ambiente de tempo de execução e o pnpm é usado para gerenciar dependências com eficiência.- Faça download do Node.js: visite o site oficial do Node.js e selecione a versão LTS (recomenda-se a versão 18.x ou superior).
- Instale o pnpm: execute o comando
npm install -g pnpm
- Verificar a instalação: Executar
node -v
responder cantandopnpm -v
confirmando que o número da versão está sendo exibido corretamente.
- Instalar o ToolSDK.ai
O ToolSDK.ai é atualmente distribuído por meio de um repositório do GitHub, seja clonando seu código ou usando diretamente os pacotes npm (dependendo da versão). O que se segue pressupõe uma instalação do npm:- Crie uma pasta de projeto e vá para o diretório:
mkdir my-ai-project cd my-ai-project
- Inicialize o projeto e instale o ToolSDK.ai:
pnpm init pnpm add @toolsdk-ai/core
- Se você precisar de um servidor MCP específico (por exemplo, o servidor de API do GitHub), instale o pacote correspondente:
pnpm add @modelcontextprotocol/server-github
- Crie uma pasta de projeto e vá para o diretório:
- Configuração de variáveis de ambiente
Alguns servidores MCP, como a API do GitHub, exigem chaves de API. Por exemplo, o servidor GitHub requerGITHUB_PERSONAL_ACCESS_TOKEN
.- Gerar um token de acesso pessoal do GitHub: faça login no GitHub, vá para "Configurações > Configurações do desenvolvedor > Tokens de acesso pessoal" e crie um novo token.
- No diretório raiz do projeto, crie o arquivo
.env
Arquivo, adicionar:GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
Uso das funções principais
A principal funcionalidade do ToolSDK.ai é conectar rapidamente servidores MCP e ferramentas de IA para criar agentes de IA ou fluxos de trabalho automatizados. Veja abaixo um guia passo a passo detalhado dos principais recursos:
Função 1: Uma linha de código para acessar o servidor MCP
O melhor recurso do ToolSDK.ai é sua simplicidade. Os desenvolvedores podem chamar o servidor MCP com uma única linha de código. Por exemplo, conectar-se ao servidor da API do GitHub:
import { ToolSDK } from '@toolsdk-ai/core';
const github = ToolSDK.connect('@modelcontextprotocol/server-github');
- procedimento::
- Certifique-se de que ele esteja instalado
@modelcontextprotocol/server-github
Pacote. - Importe o ToolSDK em seu código e use o
connect
especifica o nome do pacote do servidor. - Invocar funções do servidor, como obter informações do repositório do GitHub:
const repo = await github.getRepo('owner/repo'); console.log(repo);
- Certifique-se de que ele esteja instalado
Função 2: Criação de um agente de IA
O ToolSDK.ai oferece suporte à criação rápida de agentes de IA que combinam modelos de IA e servidores MCP para lidar com tarefas complexas.
- procedimento::
- Instale um SDK de IA (como o OpenAI ou o Vercel AI SDK):
pnpm add @ai-sdk/openai
- Configure o modelo de IA e o servidor MCP:
import { generateText } from 'ai'; import { openai } from '@ai-sdk/openai'; import { ToolSDK } from '@toolsdk-ai/core'; const github = ToolSDK.connect('@modelcontextprotocol/server-github'); const { text } = await generateText({ model: openai('gpt-4o'), prompt: 'Summarize the README of owner/repo', tools: [github], }); console.log(text);
- O modelo de IA chama automaticamente o servidor MCP para obter dados e gerar resultados.
- Instale um SDK de IA (como o OpenAI ou o Vercel AI SDK):
Função 3: Criação de fluxos de trabalho automatizados
O ToolSDK.ai oferece suporte à criação de fluxos de trabalho automatizados do tipo Zapier. Por exemplo, buscar automaticamente dados de problemas do GitHub e enviá-los para o Slack.
- procedimento::
- Instale o pacote do servidor Slack MCP:
pnpm add @modelcontextprotocol/server-slack
- Configure o fluxo de trabalho:
const slack = ToolSDK.connect('@modelcontextprotocol/server-slack'); const issues = await github.getIssues('owner/repo'); await slack.sendMessage('#channel', `New issues: ${issues.length}`);
- Execute o código para automatizar o envio de uma mensagem para o canal do Slack especificado.
- Instale o pacote do servidor Slack MCP:
Recurso 4: adição de um servidor MCP personalizado
Os desenvolvedores podem adicionar servidores MCP personalizados por meio de repositórios do GitHub.
- procedimento::
- entrevistas Repositório GitHub do ToolSDK.ai.
- Repositório Fork, no
packages/uncategorized
Crie um novo arquivo na pasta, por exemplo.my-mcp-server.json
. - Edite o arquivo JSON para definir as informações do servidor:
{ "type": "mcp-server", "name": "MyServer", "packageName": "@myorg/server-myserver", "description": "Custom MCP server", "url": "https://github.com/myorg/servers", "runtime": "node", "license": "MIT" }
- Envie uma Pull Request e aguarde até que a IA classifique e gere automaticamente o pacote npm.
advertência
- Certifique-se de que as variáveis de ambiente estejam configuradas corretamente para evitar falhas nas chamadas à API.
- O ecossistema de servidores MCP do ToolSDK.ai ainda está em expansão, e alguns servidores podem exigir configuração adicional.
- Verifique regularmente se há atualizações em seus repositórios do GitHub para obter a lista mais recente de servidores MCP.
cenário do aplicativo
- Desenvolvimento rápido de agentes de IA
Os desenvolvedores podem usar o ToolSDK.ai para criar rapidamente agentes de IA, conectar-se às APIs do GitHub para obter dados do repositório de código e gerar relatórios de análise de código por meio de modelos de IA. Adequado para prototipagem rápida por desenvolvedores independentes ou equipes de startups. - Fluxos de trabalho automatizados
As organizações podem usar o ToolSDK.ai para criar fluxos de trabalho automatizados, como monitorar repositórios do GitHub para atualizações de problemas e notificar automaticamente as equipes, reduzindo as tarefas manuais e aumentando a eficiência. - Ferramentas de personalização ampliadas
Os desenvolvedores podem ampliar a funcionalidade do ToolSDK.ai adicionando servidores MCP personalizados, como a conexão com bancos de dados internos ou APIs de terceiros, para atender a necessidades comerciais específicas.
QA
- O ToolSDK.ai é gratuito?
Sim, o ToolSDK.ai oferece um SDK TypeScript gratuito, e os desenvolvedores podem usar a funcionalidade principal gratuitamente. Alguns servidores MCP podem exigir uma chave de API ou uma assinatura paga (por exemplo, a API do GitHub para recursos premium). - Qual é a experiência de desenvolvimento necessária?
Os usuários precisam ter experiência básica de desenvolvimento em TypeScript ou JavaScript e familiaridade com Node.js e pnpm. O conhecimento das chamadas de API e da configuração de variáveis de ambiente o ajudará a começar mais rapidamente. - Como obter a lista mais recente de servidores MCP?
entrevistas Repositório GitHub do ToolSDK.aiVerpackages-list.json
para obter uma lista atualizada de servidores.