O que codex-local-subagent faz?
Servidor MCP somente leitura e skill para a ferramenta Codex, permitindo análise de repositórios com LLM local.
Visão Geral
Este skill expõe um subagente alimentado por um modelo de linguagem local (LLM) que pode ser usado para analisar repositórios de código. Ele funciona como um servidor MCP (Model Context Protocol) que aceita conexões de agentes de IA como Claude Code, Cursor ou Codex, e oferece um conjunto de ferramentas para inspecionar e compreender bases de código sem fazer alterações.
Plataformas Suportadas
- Codex: Ativado como skill para delegar tarefas de análise
- Cursor: Compatível via MCP
- Qualquer cliente MCP: Pode se conectar ao servidor
Funcionalidades
- Consulta de estrutura de diretórios
- Leitura de arquivos (modo somente leitura)
- Busca de padrões com expressões regulares
- Análise estática básica (identificação de funções, classes, dependências)
- Suporte a múltiplos formatos de arquivo (Python, JavaScript, TypeScript, Markdown, etc.)
Configuração
Para usar este skill, você precisa ter um LLM local rodando (por exemplo, via Ollama, llama.cpp ou LM Studio). O servidor MCP se comunica com o LLM via stdin/stdout ou WebSocket.
Configuração no Codex
{
"mcpServers": {
"local-subagent": {
"command": "npx",
"args": ["@ossi-1337/codex-local-subagent"]
}
}
}
Configuração no Cursor
No arquivo ~/.cursor/mcp.json:
{
"mcpServers": {
"local-subagent": {
"command": "npx",
"args": ["@ossi-1337/codex-local-subagent"]
}
}
}
Uso
Uma vez configurado, o agente principal pode chamar as ferramentas do subagente usando o protocolo MCP. Exemplo de prompt:
Use o subagente local para analisar a estrutura do diretório
./srce identificar os arquivos que contêm definições de classes.
Ferramentas Disponíveis
| Ferramenta | Descrição |
|---|---|
list_directory | Lista o conteúdo de um diretório |
read_file | Lê o conteúdo de um arquivo |
search_files | Busca padrões em múltiplos arquivos |
analyze_structure | Analisa a estrutura geral do repositório |
find_definition | Localiza definições de funções/classes |
Exemplo de Fluxo
- Agente principal recebe uma solicitação do usuário
- Agente delega a tarefa ao subagente via MCP
- Subagente consulta o LLM local para interpretar a solicitação
- Subagente executa as ferramentas necessárias no repositório
- Resultados são retornados ao agente principal
Notas
- O subagente é somente leitura: nunca modifica arquivos
- Todo o processamento é feito localmente, preservando a privacidade
- É necessário um LLM local funcional para operar