Sobre o projeto

opencode-mcp é um servidor MCP (Model Context Protocol) que faz a ponte entre clientes MCP — como Claude Desktop, Claude Code, Cursor, VS Code, Windsurf e outros — e a API headless do OpenCode. Ele permite delegar tarefas de programação, fazer perguntas, implementar funcionalidades, monitorar trabalho em segundo plano, responder a prompts e permissões, e revisar alterações em projetos. Os principais recursos incluem: - **70 ferramentas, 10 recursos e 5 prompts** para interação abrangente. - **Flexibilidade de fluxo de trabalho**: escolha entre execuções síncronas (`opencode_run`), execução em segundo plano (`opencode_fire` com `opencode_check`/`opencode_wait`) e gerenciamento de jobs (`opencode_job_list`, `opencode_job_get`, `opencode_job_cancel`). - **Configuração e orientação**: `opencode_setup`, `opencode_context` e `opencode_provider_models` ajudam a configurar provedores e modelos. - **Suporte a múltiplos projetos**: ferramentas com escopo de projeto aceitam caminhos absolutos no servidor OpenCode, com suporte a caminhos POSIX, de unidade Windows e UNC. - **Configuração**: variáveis de ambiente como `OPENCODE_BASE_URL`, `OPENCODE_AUTO_SERVE`, `OPENCODE_DEFAULT_PROVIDER` e `OPENCODE_DEFAULT_MODEL` permitem personalização. Um perfil de ferramentas menor, `essential`, está disponível via `OPENCODE_TOOL_PROFILE`. - **Desenvolvimento e testes**: inclui testes unitários com fixtures locais e testes de fumaça ao vivo para verificação controlada. Requer Node.js 22 ou mais recente. O pacote é distribuído no npm e pode ser usado via `npx opencode-mcp`. A documentação cobre configuração para vários clientes, referência de ferramentas, recursos, prompts, exemplos e arquitetura.