MCP Calculator

What is MCP Calculator?

MCP Calculator is a Go implementation of a Model Context Protocol (MCP) server that provides calculator (addition) and greeting functionality. It follows the official MCP specification and uses JSON‑RPC 2.0 for communication.

How to use MCP Calculator?

Clone the repository, run go mod download, then start the server with go run main.go (listens on port 8080). Send JSON‑RPC 2.0 requests via HTTP POST to http://localhost:8080 using tools like add (params a, b) or greeting (params name).

Key features of MCP Calculator

• Full JSON‑RPC 2.0 implementation
• MCP protocol support with capability negotiation
• Tool registration and execution (add, greeting)
• Resource handling according to MCP spec
• Standard error handling with proper error codes
• Security guidelines: user consent, data privacy, tool safety

Use cases of MCP Calculator

• Perform basic arithmetic (addition) via an MCP‑compliant server
• Generate personalized greetings through a resource endpoint
• Test or prototype MCP protocol interactions in Go
• Demonstrate JSON‑RPC 2.0 tool and resource patterns

FAQ from MCP Calculator

What runtime does MCP Calculator require?

Go 1.21 or higher.

How do I install and start the server?

Clone the repository, run go mod download, then execute go run main.go. The server starts on port 8080.

What tools are available?

Two tools: add (takes parameters a and b, returns their sum) and greeting (takes parameter name, returns a greeting).

How are requests and responses formatted?

All communication uses JSON‑RPC 2.0. Requests include jsonrpc, id, method, and params. Responses contain jsonrpc, id, and result (or error with code, message, and optional data).

What security measures are implemented?

The server follows MCP security guidelines: tools require explicit invocation, no data is shared without requests, tool execution is controlled and validated, and proper error reporting is used.