MCP Golang

MCP golang is an unofficial implementaion of the Model Context Protocol in Go.

Example Usage

type Content struct {
    Title       string  `json:"title" jsonschema:"required,description=The title to submit"`
    Description *string `json:"description" jsonschema:"description=The description to submit"`
}
type MyFunctionsArguments struct {
    Submitter string  `json:"submitter" jsonschema:"required,description=The name of the thing calling this tool (openai, google, claude, etc)"`
    Content   Content `json:"content" jsonschema:"required,description=The content of the message"`
}

func main() {
    done := make(chan struct{})
    s := server.NewServer(stdio.NewStdioServerTransport())
    err := s.RegisterTool("hello", "Say hello to a person", func (arguments MyFunctionsArguments) (*server.ToolResponse, error) {
        return server.NewToolReponse(server.NewTextContent(fmt.Sprintf("Hello, %s!", arguments.Submitter))), nil
    })
    if err != nil {
        panic(err)
    }
    <-done
}

This will start a server using the stdio transport (used by claude desktop), host a tool called "hello" that will say hello to the user who submitted it.

You can use raw go structs as the input to your tools, the library handles generating the messages, deserialization, etc.

Library Goals and non-goals

• The libary api should be simple and easy to use for basic cases of the protocol but we are explicitly aiming to support production use cases first.
• Where complexity arises, the library will have sane defaults and allow the user to override them if needed.
• The library aims to support servers first and foremost, when the server features are stable, we will work on adding client support.

Contributions

Contributions are more than welcome! Please check out our contribution guidelines.

Server Feature Implementation

Tools

• Tool Calls
• Programatically generated tool list endpoint
• [ ]

Prompts

• Prompt Calls
• Programatically generated prompt list endpoint

Resources

• Resource Calls
• Programatically generated resource list endpoint

Transports

• Stdio
• SSE
• Custom transport support
• HTTPS with custom auth support - in progress. Not currently part of the spec but we'll be adding experimental support for it.

Client Feature Implementation

Currently under development