OpenCode: OpenCode Custom Tools

Última atualização: 2026-08-31

--- title: Ferramentas Personalizadas e oh-my-openagent do OpenCode description: Crie ferramentas personalizadas para expandir o OpenCode e explore o ecossistema de plugins oh-my-openagent order: 19 lang: pt-br

Ferramentas personalizadas e plugins da comunidade permitem que as capacidades do OpenCode se expandam infinitamente.

1. O Que Você Vai Aprender


2. Desenvolvimento de Ferramentas Personalizadas

Via MCP (Recomendado):

JSON
{
  "mcp": {
    "my-tool": {
      "command": "node",
      "args": ["./tools/my-tool-server.js"]
    }
  }
}

Template TypeScript MCP Server:

TYPESCRIPT
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  { name: "my-tool", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "my_custom_tool",
    description: "Custom tool description",
    inputSchema: {
      type: "object",
      properties: { input: { type: "string" } },
      required: ["input"]
    }
  }]
}));

Python MCP Server também suportado.


3. oh-my-openagent

oh-my-openagent é o ecossistema de plugins comunitário do OpenCode (como oh-my-zsh para Zsh).

BASH
git clone https://github.com/anomalyco/oh-my-openagent ~/.config/opencode/oh-my-openagent

Plugins comuns:

Plugin Função
git-enhanced Operações Git aprimoradas
docker-helper Gerenciamento de contêineres Docker
code-style Verificação e auto-fix de estilo de código
test-runner Execução de testes aprimorada
doc-generator Geração automática de documentação
security-scanner Scan de vulnerabilidades de segurança

4. Ecossistema Comunitário

Projeto Descrição
OpenCode Ferramenta CLI central
oh-my-openagent Plugins comunitários
MCP SDK SDK de desenvolvimento de ferramentas
CC Switch Gerenciamento de configuração API

❓ FAQ

P: Ferramentas personalizadas vs servidores MCP?

R: Ferramentas personalizadas são implementadas principalmente via servidores MCP. MCP é o padrão de protocolo; ferramentas personalizadas são a implementação concreta.

P: oh-my-openagent é seguro?

R: Plugins comunitários são mantidos por contribuidores open-source. Revise o código antes de instalar. Teste em ambientes sandbox.


📖 Resumo


📝 Exercícios

  1. Básico: Instale oh-my-openagent e habilite um plugin comunitário.

  2. Intermediário: Desenvolva um servidor MCP simples com uma ferramenta personalizada.

  3. Avançado: Desenvolva uma ferramenta personalizada prática (ex: gerador de templates) e compartilhe com a comunidade.

Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%