Skip to main content
Glama

GoMami MCP

简体中文

An unofficial Model Context Protocol server for managing GoMami servers from Claude Code and other MCP clients. It is read-only by default and has no third-party dependencies.

Not affiliated with GoMami. This is an independent community project. "GoMami" is used only to describe the service this tool works with.

Alpha. The read-only connection, account and server list calls have been tested against the live API. All other tools have only been tested against a local mock, so try them on a disposable server first.

Requirements

  • Python 3.10 or newer

  • macOS or Linux

  • A GoMami API token

Related MCP server: iotamine-mcp

Setup

  1. Sign in at gomami.io and open Create API Token. Tokens have full account access and are shown only once.

  2. Save the token. Run this, paste the token (nothing is displayed), then press Enter:

(umask 077; mkdir -p ~/.config/gomami-mcp; IFS= read -rs t; printf '%s\n' "$t" > ~/.config/gomami-mcp/token; unset t)
  1. Clone this repository and add the server to Claude Code:

claude mcp add gomami --scope user -- python3 /absolute/path/to/gomami-mcp/src/gomami_mcp.py
  1. In a new session, ask your assistant to run verify_connection.

Other MCP clients can use the same command with this configuration:

{
  "mcpServers": {
    "gomami": {
      "command": "python3",
      "args": ["/absolute/path/to/gomami-mcp/src/gomami_mcp.py"],
      "env": { "GOMAMI_MCP_ACCESS": "read" }
    }
  }
}

Configuration

Variable

Default

Purpose

GOMAMI_MCP_ACCESS

read

Access tier: read, operate or full. Unknown values fall back to read.

GOMAMI_MCP_PROTECTED_SERVERS

empty

Comma-separated server IDs that can be read but not changed.

GOMAMI_API_TOKEN

empty

Token value. Takes priority over ~/.config/gomami-mcp/token.

Tools

All 29 operations in the GoMami API reference are available.

Tier

Tools

read

verify_connection, get_account, list_ssh_keys, list_servers, get_server, list_os_templates, list_swap_options, list_isos, list_tasks, get_task, list_resource_packs, get_resource_pack

operate

All of the above, plus get_vnc_status, boot_server, restart_server, shutdown_server, power_off_server, rename_server

full

All of the above, plus rebuild_server, reset_server_password, toggle_rescue, toggle_vnc, set_iso, set_boot_order, update_server_settings, add_ssh_key, delete_ssh_key, create_resource_pack_server, delete_resource_pack_server

Safety

  • Add production servers to GOMAMI_MCP_PROTECTED_SERVERS. This is enforced by the server and cannot be overridden by a tool call.

  • State-changing tools need confirmation text, such as REBUILD <server-id>. This prevents mistakes, but a model can fill it in by itself.

  • VNC passwords and connection tokens are never returned to the chat.

  • Reset passwords are saved under ~/.config/gomami-mcp/secrets/ with mode 600.

  • Write requests are never retried automatically.

See SECURITY.md for details and limits.

Known limitations

  • The API reference does not say what value set_iso needs to eject an ISO.

  • The API reference describes GET /server/{id}/vnc as a toggle, which looks like a typo. It is placed in the operate tier to be safe.

  • The API is behind Cloudflare. Blocked requests are reported clearly, and this project does not try to work around them.

Development

python3 -m unittest discover -s tests -v

Tests use a local mock and never contact GoMami.

License

MIT

Available Tools

12 tools
get_accountAccountA
Read-onlyIdempotent

Read the account name, email address and timezone.

Inputs: no named parameters.

get_resource_packResource pack detailsA
Read-onlyIdempotent

Read a resource pack's options, including the createId values needed to create a server.

Inputs: resourcePackId (required).

get_serverServer detailsA
Read-onlyIdempotent

Read a server's configuration, network and traffic period. Set state=true to include its live state.

Inputs: serverId (required), state.

get_taskTask detailsC
Read-onlyIdempotent

Read the status of one task.

Inputs: taskId (required), serverId (required).

list_isosISOsB
Read-onlyIdempotent

List the ISO images available to this server.

Inputs: serverId (required).

list_os_templatesOS templatesA
Read-onlyIdempotent

List the OS templates available for a rebuild.

Inputs: serverId (required).

list_resource_packsResource packsB
Read-onlyIdempotent

List resource packs and their usage.

Inputs: no named parameters.

list_serversServersC
Read-onlyIdempotent

List the servers on the account.

Inputs: page, results.

list_ssh_keysSSH keysC
Read-onlyIdempotent

List the SSH public keys on the account.

Inputs: page, results.

list_swap_optionsSwap optionsB
Read-onlyIdempotent

List the swap sizes available for a rebuild.

Inputs: serverId (required).

list_tasksTasksB
Read-onlyIdempotent

List a server's recent tasks.

Inputs: serverId (required), page, results.

verify_connectionVerify connectionA
Read-onlyIdempotent

Check that the API is reachable and the token is valid.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource and action: account, SSH keys, servers, OS templates, swap options, ISOs, tasks, and resource packs. The get/list pairs are differentiated by singular versus collection semantics, and rebuild-related list tools are still distinct resources.

    Naming Consistency5/5

    All tool names use consistent snake_case verb_noun form, such as get_account, list_servers, get_server, and list_resource_packs. No mixed casing or vague standalone verbs appear.

    Tool Count5/5

    Twelve tools is well-scoped for a hosting/account management MCP surface. Each tool covers a distinct read or verification operation without obvious redundancy.

    Completeness2/5

    The surface is almost entirely read-only: it can list and inspect servers, tasks, templates, and resource packs but cannot create, rebuild, start, stop, or delete servers. The mention of createId values for creating a server and templates for rebuilds highlights missing lifecycle operations, leaving important workflows as dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      Enables Claude, Cursor, and other MCP clients to manage Iotamine cloud VPS accounts via the Iotamine REST API, including VPS lifecycle, monitoring, billing, and support operations.
      78
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Google Gemini and any MCP-compatible client to securely monitor and manage hypervisor guests — starting, stopping, rebooting, snapshotting, rolling back, and backing up VMs and containers — through the Model Context Protocol over Streamable HTTP with OAuth 2.0/OIDC authentication.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP clients such as Claude Code, Claude Desktop, and Cursor to list hosts, read metrics, inspect containers, follow logs, and, when permitted, run commands, restart containers, manage authorized_keys, and edit host lists under per-host policy, Touch ID-backed credentials, deny-lists, rate limits, and an audit log.
      MIT