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
- Desenvolvimento de ferramentas personalizadas
- Registro e configuração de ferramentas
- Ecossistema oh-my-openagent
- Instalação e uso de plugins
2. Desenvolvimento de Ferramentas Personalizadas
Via MCP (Recomendado):
{
"mcp": {
"my-tool": {
"command": "node",
"args": ["./tools/my-tool-server.js"]
}
}
}
Template TypeScript MCP Server:
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).
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
- Ferramentas personalizadas desenvolvidas via servidores MCP
- TypeScript e Python suportados
- oh-my-openagent é o ecossistema de plugins comunitário
- Plugins oferecem Git aprimorado, Docker, estilo de código etc.
- Prefira plugins comunitários; desenvolva personalizados apenas quando necessário
📝 Exercícios
-
Básico: Instale oh-my-openagent e habilite um plugin comunitário.
-
Intermediário: Desenvolva um servidor MCP simples com uma ferramenta personalizada.
-
Avançado: Desenvolva uma ferramenta personalizada prática (ex: gerador de templates) e compartilhe com a comunidade.