nakama-mcp

[!WARNING] This is a personal research project. Do not use it on any live server or production environment.

This tool was built for local experimentation and learning purposes only. It has not been audited for production use and comes with no guarantees around stability, security, or data safety.

If you need an official, supported integration between Nakama and AI tooling, wait for an official release from Heroic Labs.

Hey, I'm DannyIsYog — a software engineer at Heroic Labs. This is a side project I built to explore how AI fits into my development workflow and to get hands-on experience creating an MCP server. If you work with Nakama and Claude, I hope it saves you some time.

Connect Claude to your Nakama game server via the Model Context Protocol.

Query player accounts, inspect live matches, browse leaderboards, read storage objects, and analyze your game backend — all through natural language in Claude Desktop or any MCP client.

Features

• 30+ read tools — status, accounts, matches, leaderboards, storage, groups, notifications, purchases, RPC, channels
• 17 write tools — ban/unban accounts, write/delete storage, manage groups, send notifications (opt-in via ENABLE_WRITE_TOOLS=true)
• Read-only by default — write tools only activate when explicitly enabled
• Two API surfaces — Console API (port 7351) for admin operations, Client API (port 7350) for game-facing operations
• Zero dependencies at runtime — single static binary, no runtime required

Quick Start

Prerequisites

• A running Nakama server (local or remote)
• Go 1.25+ or a pre-built binary from Releases

Install

# From source
go install github.com/DannyIsYog/nakama-mcp-server/cmd/nakama-mcp@latest

# Or download a binary from Releases and move it to your PATH

Add to Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "nakama": {
      "command": "/path/to/nakama-mcp",
      "env": {
        "NAKAMA_HOST": "127.0.0.1",
        "NAKAMA_SERVER_KEY": "defaultkey",
        "NAKAMA_CONSOLE_PASSWORD": "your-console-password"
      }
    }
  }
}

Restart Claude Desktop. You should see the nakama-mcp tools available in a new conversation.

Configuration

Connection Examples

Multiple Servers

You can connect Claude to multiple Nakama servers simultaneously by adding multiple entries to claude_desktop_config.json. Each entry runs a separate nakama-mcp process pointing at a different server.

{
  "mcpServers": {
    "nakama-dev": {
      "command": "/path/to/nakama-mcp",
      "env": {
        "NAKAMA_HOST": "127.0.0.1",
        "NAKAMA_SERVER_KEY": "defaultkey",
        "NAKAMA_CONSOLE_PASSWORD": "password"
      }
    },
    "nakama-prod": {
      "command": "/path/to/nakama-mcp",
      "env": {
        "NAKAMA_HOST": "prod.example.com",
        "NAKAMA_PORT": "7350",
        "NAKAMA_CONSOLE_PORT": "7351",
        "NAKAMA_SERVER_KEY": "your-prod-server-key",
        "NAKAMA_CONSOLE_PASSWORD": "your-prod-console-password",
  

... [View full README on GitHub](https://github.com/DannyIsYog/nakama-mcp-server#readme)