Skip to content
MCP server

Tiny Go MCP Server

Demo Go MCP server with add, subtract and greet tools for testing MCP clients

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
1.1.2
Listing updated
today

Similar MCP servers

About Tiny Go MCP Server

Tiny Go MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README describes this as a reference server built with the tinymcp Go toolkit, which wraps the official Model Context Protocol Go SDK. Its three example tools, add, subtract and greet, exist to check that an MCP client can discover and call tools, not to deliver production arithmetic or messaging.

The server runs over stdio and is installable with go install or as a container image from the MCP registry entry. The README includes setup snippets for Cursor and Claude Desktop, and notes that server logs go to stderr so the stdin/stdout protocol stream stays clean.

It suits developers who want a small, working Go MCP server to test client wiring or to copy as a starting template for their own tools, resources and prompts.

Install

Run in a terminal

claude mcp add tiny-go-mcp -- docker run -i --rm ghcr.io/kioie/tiny-go-mcp:1.1.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tiny-go-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kioie/tiny-go-mcp:1.1.2"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tiny-go-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kioie/tiny-go-mcp:1.1.2"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tiny-go-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kioie/tiny-go-mcp:1.1.2"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tiny-go-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kioie/tiny-go-mcp:1.1.2"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tiny-go-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kioie/tiny-go-mcp:1.1.2"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

add
Adds two numbers a and b.
subtract
Subtracts b from a.
greet
Returns a greeting for a required name, with an optional greeting argument.

What it does

Stdio transport
Runs as a local subprocess that communicates with AI clients over stdin and stdout.
Example arithmetic tools
Provides add and subtract tools that take two numeric arguments for wiring tests.
Greeting tool
Offers a greet tool that takes a required name and an optional greeting.
Resource and prompt examples
The toolkit documents registering a text resource and a prompt template alongside tools.
Container image distribution
The registry entry points to an OCI image published on GitHub Container Registry.

Good for

  • Checking that an MCP client discovers and invokes tools correctly
  • Using the repository as a starting template for a Go MCP server
  • Testing stdio configuration in Cursor or Claude Desktop before building real tools

Pricing

Open source

Free and MIT licensed.

Tiny Go MCP Server FAQ

Is this server meant for production use?

No. The registry entry describes it as a demo for tinymcp tests and not for production use.

How is the server started locally?

The README says to install it with go install from the cmd/tiny-go-mcp path, or build it from source with make release, then point the client at the binary.

What Go version is required?

The README lists Go 1.26 or later as a requirement.

Is Tiny Go MCP Server free?

Yes. Tiny Go MCP Server is open source, so you can use and self-host it for free.

How do I add Tiny Go MCP Server to Claude Code?

Run this command in your terminal: claude mcp add tiny-go-mcp -- docker run -i --rm ghcr.io/kioie/tiny-go-mcp:1.1.2

What are the best alternatives to Tiny Go MCP Server?

The closest alternatives to Tiny Go MCP Server are Go Proxy MCP, MCP Server Template, Makefile MCP, GRACE Hello MCP and Crimson Crab MCP Template.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers