Skip to Content
Mélodium 0.10.3 is now available!
DocsUsageMCP Server

MCP Server

melodium-mcp is an MCP  server that exposes Mélodium program validation and standard library reference lookup to MCP-compatible AI tools, so an agent writing Mélodium code can check its own work instead of guessing. See the announcement for the full list of tools it exposes.

Build

Clone the repository and build the melodium-mcp package:

$ git clone https://gitlab.com/melodium/melodium.git
$ cd melodium
$ cargo build --release --package melodium-mcp

The resulting binary is at target/release/melodium-mcp (melodium-mcp.exe on Windows).

Install

Move the binary somewhere on PATH, so it can be called by name.

Linux / macOS

$ mkdir -p ~/.local/bin
$ cp target/release/melodium-mcp ~/.local/bin/
Note

~/.local/bin must be on PATH. If it is not already, add it to your shell profile:

$ export PATH="$HOME/.local/bin:$PATH"

Windows

> New-Item -ItemType Directory -Force $env:USERPROFILE\.local\bin
> Copy-Item target\release\melodium-mcp.exe $env:USERPROFILE\.local\bin\
Note

Add %USERPROFILE%\.local\bin to PATH through System Properties > Environment Variables, or from a terminal:

> setx PATH "$env:PATH;$env:USERPROFILE\.local\bin"

Add it to an AI tool

Claude Desktop

Edit claude_desktop_config.json:

  • Linux: ~/.config/Claude/claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "melodium": {
      "command": "melodium-mcp"
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

Register it with the CLI, from any directory:

$ claude mcp add --scope user melodium -- melodium-mcp

This writes the server to ~/.claude.json under the top-level mcpServers key, making it available in every project. Drop --scope user to register it for the current project only, or use --scope project to write it to a .mcp.json file checked into the project instead.

Cursor

Edit mcp.json:

  • Global, available in every project: ~/.cursor/mcp.json
  • Project-only, share it by committing the file: .cursor/mcp.json at the project root
{
  "mcpServers": {
    "melodium": {
      "command": "melodium-mcp"
    }
  }
}

Codex CLI

Register it with the CLI:

$ codex mcp add melodium -- melodium-mcp

This writes to ~/.codex/config.toml:

[mcp_servers.melodium]
command = "melodium-mcp"

Project-scoped servers for trusted projects go in .codex/config.toml at the project root instead.

DebugDocumentation