Almide MCP Server

An MCP (Model Context Protocol) server that lets AI agents compile, run, and check Almide code.

Tools

Resources

Setup

Prerequisites

• Node.js 18+
• almide compiler in PATH (or set ALMIDE_BIN)

Install

git clone https://github.com/almide/mcp-server.git
cd mcp-server
npm install
npm run build

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "almide": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "almide": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "ALMIDE_BIN": "/path/to/almide"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "almide": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"]
    }
  }
}

Usage Examples

Once connected, an AI agent can:

# Check code for errors
almide.check({ code: 'module app\nfn add(a: Int, b: Int) -> Int = a + b' })

# Compile to Rust
almide.compile({ code: '...', target: 'rust' })

# Run code
almide.run({ code: '...', args: ['hello'] })

# Get AST
almide.emit-ast({ code: '...' })

Environment Variables

License

MIT