Um repositório pessoal de contexto que fornece conhecimento persistente sobre projetos a agentes de programação com IA, como Codex, Claude Code e OpenCode, por meio de CLI, servidor MCP e app para desktop.
oraios/serena
Servidor MCP que oferece a agentes de programação busca de símbolos, edição semântica e refatoração no nível de uma IDE.
Alternativa open source a:JetBrains AI Assistant
- Estrelas
- 30,379
- Forks
- 2,232
- Issues abertas
- 101
- Último commit
- há 5 dias
O que é?
Serena é um toolkit que se conecta a agentes de programação com IA pelo Model Context Protocol (MCP) e oferece ferramentas que operam no nível dos símbolos, como encontrar uma função, suas referências ou implementações, em vez de depender de números de linha e busca por texto simples. Ele pode ser usado com clientes como Claude Code, Codex, Claude Desktop e plugins de assistente para IDEs, como VS Code, Cursor e JetBrains.
Serena oferece dois backends. Por padrão, usa servidores de linguagem que implementam o Language Server Protocol e abrangem mais de 40 linguagens. Como alternativa, um plugin pago para JetBrains usa o mecanismo de análise e refatoração das IDEs da JetBrains, adicionando operações de mover, inline e exclusão segura, além de uma ferramenta interativa de depuração.
O projeto também inclui um sistema de memória para compartilhar conhecimento entre sessões de agentes e uma camada de configuração escrita em YAML, com opções que podem ser definidas globalmente, por comando de inicialização, por projeto ou por cliente.
Recursos principais
- 01Encontra símbolos, referências e implementações em uma base de código.
- 02Substitui e insere conteúdo antes ou depois dos corpos dos símbolos, sem editar números de linha.
- 03Renomeia símbolos e atualiza referências em vários arquivos.
- 04Oferece suporte a mais de 40 linguagens por meio de servidores de linguagem.
- 05O plugin opcional para JetBrains adiciona operações de mover e inline, além de depuração interativa.
Casos de uso
- Permitir que um agente de programação renomeie ou mova código com segurança em um projeto grande com vários arquivos.
- Oferecer navegação precisa a um agente em um monorepo com várias linguagens.
- Manter conhecimento entre sessões de agentes com o sistema de memória integrado.
Início rápido
- 1
Instale o uv (o único pré-requisito).
- 2
Instale o Serena usando o uv.
uv tool install -p 3.13 serena-agent - 3
Inicialize o Serena e verifique a configuração.
serena init - 4
Configure um comando de inicialização no seu cliente MCP (consulte o guia do cliente).
Antes de usar
- O backend do JetBrains requer um plugin pago, embora haja um período de avaliação gratuito disponível.
- Os servidores de linguagem de algumas linguagens precisam de dependências adicionais instaladas separadamente.
- O selo indica a licença GPL-3.0-or-later, enquanto os metadados informam NOASSERTION; verifique antes de usar comercialmente.
Tópicos
Perguntas frequentes
- O que é serena?
- Servidor MCP que oferece a agentes de programação busca de símbolos, edição semântica e refatoração no nível de uma IDE. Serena é um toolkit que se conecta a agentes de programação com IA pelo Model Context Protocol (MCP) e oferece ferramentas que operam no nível dos símbolos, como encontrar uma função, suas referências ou implementações, em vez de depender de números de linha e busca por texto simples. Ele pode ser usado com clientes como Claude Code, Codex, Claude Desktop e plugins de assistente para IDEs, como VS Code, Cursor e JetBrains.
- serena é gratuito? Qual é a licença?
- serena é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
- serena ainda é mantido?
- Manutenção ativa. O último commit de serena foi em 15 de out. de 2026.
- Para que posso usar serena?
- Permitir que um agente de programação renomeie ou mova código com segurança em um projeto grande com vários arquivos. Oferecer navegação precisa a um agente em um monorepo com várias linguagens. Manter conhecimento entre sessões de agentes com o sistema de memória integrado.
- Como instalar serena?
- Instale o uv (o único pré-requisito). Instale o Serena usando o uv.: uv tool install -p 3.13 serena-agent Inicialize o Serena e verifique a configuração.: serena init Configure um comando de inicialização no seu cliente MCP (consulte o guia do cliente).
- Onde consigo serena?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/oraios/serena
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um grafo local de conhecimento do código que fornece às ferramentas de programação com IA contexto preciso para revisões via MCP e CLI.
Um curso prático de Vibe Coding que ensina não programadores e desenvolvedores a criar produtos reais com ajuda de IA, da ideia ao lançamento.
Memória persistente para agentes de programação: registra a atividade das sessões, compacta as informações com IA e injeta contexto relevante em sessões futuras.
Servidor MCP para agentes de programação com IA que mantém as saídas brutas das ferramentas fora da janela de contexto e preserva o estado da sessão após a compactação.
Uma CLI que analisa seu código e gera arquivos compactos de contexto para IA, reduzindo os tokens que assistentes de programação gastam explorando o projeto.