mcp
MCP Server example in Golang
claude mcp add --transport stdio eminetto-mcp-server go run . \ --env GO111MODULE="on" \ --env MCP_SERVER_SLUG="eminetto-mcp-server"
How to use
This MCP server is a Golang-based implementation intended to run as a standard MCP server. It accepts MCP protocol commands from clients and responds according to the server’s logic implemented in Go. To start the server, launch the executable in an environment with Go installed; the server will listen on the configured port (default or environment-defined) and handle MCP requests from connected clients. Once running, you can connect with MCP-compatible clients to issue commands, retrieve data, and observe the server’s responses as defined by the MCP protocol implementation within this Go project.
How to install
Prerequisites:
- Go 1.20+ installed on your system
- Git for cloning the repository (optional if you already have the source)
Installation steps:
-
Clone the repository (or download the source): git clone https://github.com/your-organization/eminetto-mcp-server.git cd eminetto-mcp-server
-
Ensure module dependencies are resolved: go mod download
-
Run the server directly (from source): go run .
-
(Optional) Build a binary for production: go build -o mcp-server ./mcp-server
-
Configure environment variables if needed (see additional notes for details): export MCP_PORT=12345 export MCP_HOST=0.0.0.0
-
Verify the server starts and listens on the configured port.
Notes:
- If the repository uses specific environment variables or configuration files, set them before starting.
- For production deployments consider building a static binary and configuring systemd or another service manager to manage the process.
Additional notes
Tips and common issues:
- Ensure you have a compatible Go version (modules enabled) to avoid dependency resolution issues.
- If the server binds to a port already in use, stop the conflicting service or change MCP_PORT.
- When running behind a reverse proxy or in containerized environments, expose the correct port and ensure firewalls allow MCP traffic.
- Check logs for protocol negotiation messages to troubleshoot handshake failures or unsupported MCP commands.
- If you need to customize behavior, modify the Go source files and re-run the build or run commands above.
Related MCP Servers
trpc-agent-go
trpc-agent-go is a powerful Go framework for building intelligent agent systems using large language models (LLMs) and tools.
station
Station is our open-source runtime that lets teams deploy agents on their own infrastructure with full control.
tiger-cli
Tiger CLI is the command-line interface for Tiger Cloud. It includes an MCP server for helping coding agents write production-level Postgres code.
gopls
MCP server for golang projects development: Expand AI Code Agent ability boundary to have a semantic understanding and determinisic information for golang projects.
kubernetes
A Model Context Protocol (MCP) server for the Kubernetes API.
gcp-cost
💰 An MCP server that enables AI assistants to estimate Google Cloud costs, powered by Cloud Billing Catalog API and built with Genkit for Go