DevScope MCP

O DevScope fornece contexto confiável de um projeto para agentes de IA no VS Code. Ele analisa tecnologias, estrutura, regras do AGENTS.md, branch atual e código-fonte sem permitir comandos arbitrários.

Sistemas suportados

• Windows 10/11

• WSL

• Linux

• macOS

A configuração gerada é a mesma em todos os sistemas. O VS Code inicia o comando devscope-mcp, instalado no PATH pelo Python.

Related MCP server: Code Expert MCP Server

Requisitos

• Python 3.11 ou superior

• Git

• VS Code com suporte a MCP

Docker, Node.js e Ripgrep são opcionais. O comando doctor informa o que está disponível.

Instalação para desenvolvimento

python -m venv .venv

Windows PowerShell:

.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -e ".[dev]"

Linux, WSL ou macOS:

source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e ".[dev]"

A instalação cria dois comandos:

devscope      CLI de configuração e diagnóstico
devscope-mcp  servidor MCP usado pelo VS Code

Uso em outro projeto

Entre na pasta do projeto que receberá o DevScope:

cd caminho/do/meu-projeto
devscope init

O comando cria, sem sobrescrever arquivos existentes:

devscope.json
AGENTS.md
.vscode/mcp.json

Para definir manualmente a branch base:

devscope init --base-branch development

Para substituir arquivos já existentes conscientemente:

devscope init --force

Depois, abra a pasta no VS Code:

code .

No VS Code, execute MCP: List Servers, selecione devscope e inicie o servidor.

Comandos da CLI

Diagnosticar o ambiente

devscope doctor

Verifica:

• sistema operacional;

• Python;

• Git;

• Docker;

• Node.js;

• Ripgrep;

• VS Code;

• presença de devscope.json, AGENTS.md e .vscode/mcp.json.

Saída em JSON:

devscope doctor --json

Configurar um projeto

devscope init

A configuração gerada usa este servidor MCP:

{
  "servers": {
    "devscope": {
      "type": "stdio",
      "command": "devscope-mcp",
      "args": [
        "--project-root",
        "${workspaceFolder}",
        "--config",
        "${workspaceFolder}/devscope.json"
      ]
    }
  }
}

Não existem caminhos fixos como C:\\Users\\... ou /home/..., por isso o arquivo funciona para toda a equipe.

Analisar o projeto

devscope scan

Identifica linguagens, frameworks, gerenciadores de pacotes, testes, Docker, CI e arquivos importantes.

Atualizar a configuração

devscope upgrade

Migra devscope.json para a versão atual do schema sem alterar código do projeto.

Ferramentas MCP

• health_check

• scan_project

• analyze_current_branch

• search_code_context

• get_task_context

Exemplos no chat do agente:

Use o DevScope para analisar este projeto.

Use o DevScope para comparar minha branch atual com development.

Use o DevScope para montar o contexto da tarefa de bloquear contas trial expiradas.

Segurança

O MVP funciona em modo somente leitura:

• não altera código;

• não cria commits;

• não faz push;

• não executa comandos fornecidos livremente pelo agente;

• restringe buscas à pasta do projeto;

• usa apenas comandos Git previamente permitidos.

Desenvolvimento e validação

pytest
ruff check .
python -m compileall src tests

Para iniciar o servidor manualmente:

devscope-mcp --project-root .

Para mostrar a configuração resolvida sem iniciar o MCP:

devscope-mcp --project-root . --print-config