Escrito por

Artigo Evandro Wendt · 8 hr atrás 2m read

MCP Sem Alucinações: Contexto em Tempo Real de Rotinas para ObjectScript

#Caché #InterSystems IRIS #Open Exchange #Artificial Intelligence (AI) #Generative AI (GenAI)

Motivação

Por que precisamos disso?

Falta de Contexto Compilado: As ferramentas de IA veem apenas o código-fonte; elas não sabem como a rotina compilada final realmente é.
Alucinação de Macros: Como a IA não vê nossos arquivos#includeou macros do sistema, ela frequentemente os “inventa”, desperdiçando tempo durante a depuração.
Lacuna na Documentação: A otimização de lógica mais profunda frequentemente exige compreender macros internas que não estão totalmente documentadas publicamente.
Sobrecarga Manual: Atualmente, a única forma de corrigir isso é usar manualmente a extensão do IRIS no VS Code para encontrar a “verdade” na rotina.

A Solução: Este servidor MCP dá à IA “olhos” dentro da sua instância IRIS, permitindo que ela leia rotinas e expanda macros automaticamente antes de sugerir código para você.

Início Rápido

Experimente este servidor MCP com o projeto ObjectScript apiPub.

Busque a rotina para api.cls:

Pressionectrl+shift+v para visualizar a rotina compilada. Em termos de compilador, isso é chamado de código intermediário legível. Modelos de LLM não têm esse contexto — é por isso que até mesmo modelos avançados “inventam” macros, pois não sabem como o código expandido realmente se parece.

Eles também não sabem quais arquivos .inc são importados, nem no que as macros $$$xxxdentro deles se expandem.

Por exemplo, um arquivo .inc pode incluir explicitamente macros do sistema:

Se você estiver conectado a uma instância do IRIS, poderá navegar diretamente nesses arquivos de macros:

Sem incluir explicitamente essas macros de sistema, não há como acessar esses arquivos — e o LLM não tem nenhuma visibilidade sobre eles.

Use a pasta .vscode , adicione o seguinte a mcp.json:

{
  "servers": {
    "intersystemsObjectscriptRoutine": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "intersystems-objectscript-routine-mcp"],
      "env": {
        "IRIS_URL": "http://localhost:52773",
        "IRIS_NAMESPACE": "IRISAPP",
        "IRIS_USERNAME": "_SYSTEM",
        "IRIS_PASSWORD": "SYS"
      }
    }
  }
}