README

Almide MCP Server

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

Tools

Tool	Description
`compile`	Compile `.almd` source to Rust or TypeScript
`run`	Compile and execute `.almd` source with arguments
`check`	Check for syntax/compilation errors with diagnostic hints
`emit-ast`	Parse source and return the AST as JSON

Resources

Resource	URI	Description
Grammar	`almide://grammar`	EBNF grammar + stdlib reference

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

Variable	Description	Default
`ALMIDE_BIN`	Path to almide binary	`almide` (from PATH)

License

MIT

Almide MCP Server

README

Almide MCP Server

Tools

Resources

Setup

Prerequisites

Install

Claude Code

Claude Desktop

Cursor

Usage Examples

Environment Variables

License

Recommended Servers