README.md
Compile, run, and check Almide code with AI agents
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
Tools (4)
compileCompile .almd source to Rust or TypeScriptrunCompile and execute .almd source with argumentscheckCheck for syntax/compilation errors with diagnostic hintsemit-astParse source and return the AST as JSONEnvironment Variables
ALMIDE_BINPath to almide binaryConfiguration
claude_desktop_config.json
{"mcpServers": {"almide": {"command": "node", "args": ["/path/to/mcp-server/dist/index.js"], "env": {"ALMIDE_BIN": "/path/to/almide"}}}}Try it
→Check the following Almide code for any syntax or compilation errors: [code]
→Compile this Almide module into Rust code: [code]
→Execute this Almide script with the argument 'hello' and show me the output
→Generate the AST for this Almide function to help me understand its structure