Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Nim Language Server

nimlangserver is a language server for Nim. It can run in two modes:

  • LSP server — provides Nim language intelligence to editors and IDEs (VSCode, Neovim, Helix, Emacs, and more).
  • MCP server — exposes Nim-aware tools to AI coding agents (GitHub Copilot, Claude Code, Gemini, and more).

LSP is the default mode. Running nimlangserver is equivalent to nimlangserver --lsp.

Demo

LSP:

LCP mode demo

MCP:

MCP mode demo

Installation

nimlangserver requires Nim >= 1.6.8 and nimble >= 0.16.1.

Install the latest release into $HOME/.nimble/bin:

nimble install -g nimlangserver

From source

Clone the repository, then install:

nimble install -g

Or build the binary without installing it:

nimble build

Windows users

Set up your development environment in WSL — clone and edit your projects inside the WSL file system.

If you use VSCode, use it with the WSL extension. Run terminal-based editors like Neovim or Helix directly in the WSL shell.

Even though nimlangserver works on native Windows, you will get better performance and stability in WSL mode.

Once installed, connect your editor by following the LSP server setup instructions, or give your AI coding agent semantic Nim understanding by following the MCP server setup instructions.