# Tiny Go MCP Server

> Tiny Go MCP Server is an open-source MCP server for developer tools. Demo Go MCP server with add, subtract and greet tools for testing MCP clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/kioie/tiny-go-mcp-server/tree/HEAD/cmd/tiny-go-mcp
- **MCP Registry name:** io.github.kioie/tiny-go-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Go Proxy MCP](https://ai-powered.com/mcp/go-proxy-mcp): Go Proxy MCP is an open-source MCP server for developer tools.
- [MCP Server Template](https://ai-powered.com/mcp/mcp-server-template): MCP Server Template is an open-source MCP server for developer tools.
- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [GRACE Hello MCP](https://ai-powered.com/mcp/grace-hello-mcp): GRACE Hello MCP is an open-source MCP server for developer tools.
- [Crimson Crab MCP Template](https://ai-powered.com/mcp/crimson-crab-mcp-template): Crimson Crab MCP Template is an open-source MCP server for ai models and llm tooling.
- [Simple MCP](https://ai-powered.com/mcp/simple-mcp): Simple MCP is an open-source MCP server for developer tools.
- [Gopls MCP](https://ai-powered.com/mcp/gopls-mcp): Gopls MCP is an open-source MCP server for developer tools.
- [Linux MCP daemon (mcpd)](https://ai-powered.com/mcp/linux-mcp-daemon-mcpd): Linux MCP daemon (mcpd) is an open-source MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/tiny-go-mcp-server
