Netmind Code Interpreter

Execute código usando a API Netmind.

Documentação

Netmind Code Interpreter

O serviço de IA Code Interpreter, construído e personalizado pela equipe da NetMind, é uma solução de alta qualidade, robusta e econômica para executar código em mais de 14 linguagens de programação por meio de um ambiente de nuvem seguro. Ele é totalmente compatível com servidores MCP, permitindo integração perfeita com agentes de IA.

Componentes

Ferramentas

  • execute_code: Executa código na linguagem de programação especificada com execução segura em nuvem.
    • language: obrigatório: Identificador da linguagem de programação (string). Valores suportados: 'python', 'javascript', 'typescript', 'java', 'cpp', 'c', 'go', 'rust', 'php', 'ruby', 'swift', 'kotlin', 'scala', 'r'
    • files: obrigatório: Lista de arquivos de código a serem executados. Cada arquivo deve ter 'name' (nome do arquivo com extensão) e 'content' (código-fonte completo como string)
    • stdin: opcional: Entrada padrão a ser fornecida ao programa durante a execução (padrão: string vazia)
    • args: opcional: Argumentos de linha de comando a serem passados ao programa (padrão: lista vazia)
    • Retorna resultados de execução com stdout, stderr e saídas de dados em caso de sucesso, ou descrição de erro em caso de falha.

Instalação

Requer UV (Gerenciador rápido de pacotes e projetos Python)

Se o uv não estiver instalado.

# Using Homebrew on macOS
brew install uv

ou

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Variáveis de Ambiente

Você pode obter uma chave de API na Netmind

  • NETMIND_API_TOKEN: Sua chave de API da Netmind

Instalação no Cursor & Claude Desktop && Windsurf

Adicione esta ferramenta como um servidor mcp editando o arquivo de configuração do Cursor/Claude/Windsurf.

{
  "mcpServers": {
    "code-interpreter": {
      "env": {
        "NETMIND_API_TOKEN": "XXXXXXXXXXXXXXXXXXXX"
      },
      "command": "uvx",
      "args": [
        "netmind-code-interpreter-mcp"
      ]
    }
  }
}

Recursos

Principais recursos da API NetMind Code Interpreter Oferecemos um conjunto robusto de recursos que lidam com a complexidade da execução de código, para que você possa se concentrar no que realmente importa.

  • Suporte Unificado a Múltiplas Linguagens: Execute código na linguagem que você precisar, sem alterações de configuração. Nosso ambiente oferece suporte nativo a Python, JavaScript, Java, Go, C++, Rust, Ruby, PHP e muito mais, cada um executado em um runtime otimizado e consistente.
  • Gerenciamento de Arquivos e E/S Sem Complicações: Integre seus dados com facilidade. Envie seus scripts, CSVs e outros arquivos baseados em texto diretamente para o runtime. Seu código pode ler, escrever e processar esses arquivos em um sistema de arquivos totalmente isolado, garantindo segurança e integridade dos dados.
  • Geração Automática de Imagens e Artefatos: Transforme dados em visuais automaticamente. Código que gera gráficos, tabelas ou diagramas terá a saída capturada automaticamente e entregue a você como um link seguro. Obtenha seus PNGs, JPEGs e outros resultados sem etapas adicionais.
  • Segurança e Desempenho de Nível Empresarial: Execute qualquer código com total tranquilidade. Cada execução ocorre em um contêiner descartável, totalmente isolado, com limites razoáveis de recursos de memória, CPU e tempo. Com inicialização rápida de contêineres e suporte a concorrência massiva, nossa plataforma é construída para desempenho e segurança em escala de produção.

Linguagens Suportadas

  • Python
  • JavaScript/TypeScript
  • Java
  • C/C++
  • Go
  • Rust
  • PHP
  • Ruby
  • Swift
  • Kotlin
  • Scala

Configuração

Defina seu token de API da Netmind como uma variável de ambiente:

export NETMIND_API_TOKEN="your-api-token-here"

Uso

Iniciando o Servidor

# using Python module
python -m netmind_code_interpreter.server

Testando o Servidor

Execute o cliente de teste para verificar se tudo está funcionando:

python tests/test_client.py

Integração com Cliente MCP

O servidor pode ser usado com qualquer cliente compatível com MCP. Veja como configurá-lo:

  1. Inicie o servidor na porta desejada (padrão: 8000)
  2. Configure seu cliente MCP para conectar-se a http://localhost:8000/sse
  3. Use a ferramenta execute_code para executar código

Referência da API

Ferramenta execute_code

Executa código na linguagem de programação especificada.

Parâmetros:

  • language (str): Identificador da linguagem de programação
  • files (List[Dict]): Lista de arquivos de código a serem executados
    • name (str): Nome do arquivo com a extensão apropriada
    • content (str): Código-fonte completo como string
  • stdin (str, opcional): Conteúdo da entrada padrão
  • args (List[str], opcional): Argumentos de linha de comando

Retornos:

  • Sucesso: {"run": {"stdout": "...", "stderr": "...", "data": [...]}}
  • Erro: {"error": "error description", "run": {"stdout": "", "stderr": "..."}}

Exemplo:

result = await client.call_tool("execute_code", {
    "language": "python",
    "files": [
        {
            "name": "hello.py", 
            "content": "print('Hello, World!')"
        }
    ]
})

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.