Primitive Go

v1.0.0Developer Toolsstable

A Go implementation of an MCP (Model Context Protocol) server tools

golangllmmcp
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is Primitive Go?

Primitive Go is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to go implementation of an mcp (model context protocol) server tools

A Go implementation of an MCP (Model Context Protocol) server tools

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Go implementation of an MCP (Model Context Protocol) serve

Use Cases

Go-based MCP server implementation
Lightweight tool protocol support
prasanthmj

Maintainer

LicenseMIT
Languagego
Versionv1.0.0
UpdatedDec 23, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx primitive-go

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Primitive Go

Primitive Go MCP Server is a Go-based implementation of an MCP server that exposes image generation capabilities using OpenAI's DALL-E model. It accepts natural-language text prompts and returns AI-generated images saved to a configurable local download directory. Developers looking for a lightweight, fast MCP server binary written in Go can use it as a reference implementation or as a practical image generation tool within Claude Desktop.

Prerequisites

  • Go 1.19 or higher installed
  • An OpenAI API key with DALL-E image generation access
  • Claude Desktop or another MCP-compatible client
  • A writable directory for saving generated images
  • Git (to clone the repository)
1

Clone the repository

Clone the primitive-go-mcp-server repository from GitHub.

git clone https://github.com/prasanthmj/primitive-go-mcp-server.git
cd primitive-go-mcp-server
2

Build the server binary

Compile the Go source code into an executable binary placed in the ./bin/ directory.

go build -o ./bin/imagegen-go ./main
3

Create a directory for generated images

Create the directory where the server will save generated images, or use an existing downloads folder.

mkdir -p ~/Downloads/ai-images
4

Set your OpenAI API key and download path

Export the required environment variables. OPENAI_API_KEY authenticates with OpenAI and DEFAULT_DOWNLOAD_PATH specifies where images are saved.

export OPENAI_API_KEY="your-openai-api-key-here"
export DEFAULT_DOWNLOAD_PATH="/Users/yourname/Downloads/ai-images"
5

Add the server to your MCP client configuration

Register the compiled binary in Claude Desktop's configuration file with the required environment variables.

Primitive Go Examples

Client configuration

Add Primitive Go MCP Server to Claude Desktop pointing to the compiled binary with your OpenAI credentials.

{
  "mcpServers": {
    "imagegen-go": {
      "command": "/path/to/primitive-go-mcp-server/bin/imagegen-go",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here",
        "DEFAULT_DOWNLOAD_PATH": "/Users/yourname/Downloads/ai-images"
      }
    }
  }
}

Prompts to try

Example prompts to generate images through Claude Desktop using the Primitive Go MCP server.

- "Generate an image of a riverside home at sunset in cinematic style."
- "Create a watercolor painting of a mountain landscape with a lake reflection."
- "Generate a futuristic city skyline at night with neon lights."
- "Make an image of a golden retriever playing in autumn leaves, photorealistic style."

Troubleshooting Primitive Go

go build fails with 'cannot find module' errors

Run 'go mod tidy' inside the repository directory to download all required Go module dependencies before building. Ensure your Go version is 1.19 or higher with 'go version'.

Image generation returns an API authentication error

Verify that OPENAI_API_KEY is set correctly in the env block of your MCP client config. The key must have DALL-E access; check your OpenAI account to confirm image generation is enabled for your tier.

Generated images are not appearing in the expected folder

Check that DEFAULT_DOWNLOAD_PATH points to an existing directory that the server process has write access to. Create the directory if it does not exist and confirm permissions with 'ls -la' on the parent directory.

Frequently Asked Questions about Primitive Go

What is Primitive Go?

Primitive Go is a Model Context Protocol (MCP) server that go implementation of an mcp (model context protocol) server tools It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Primitive Go?

Follow the installation instructions on the Primitive Go GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Primitive Go?

Primitive Go works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Primitive Go free to use?

Yes, Primitive Go is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "primitive-go": { "command": "npx", "args": ["-y", "primitive-go"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Primitive Go?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides