Tiny Go MCP Server
Demo Go MCP server with add, subtract and greet tools for testing MCP clients
- 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.2Add to claude_desktop_config.json
{
"mcpServers": {
"tiny-go-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kioie/tiny-go-mcp:1.1.2"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tiny-go-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kioie/tiny-go-mcp:1.1.2"
]
}
}
}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.