MCP Server Sample

🚀 MCP Server Sample

This project is a basic implementation of a server compliant with the Model Context Protocol (MCP). MCP is a protocol used to establish communication between a model and a locally running MCP server.

🚀 Quick Start

Prerequisites

• Git
• Go

Steps

1. Clone the repository:

git clone <repository-url>
cd mcp-server-sample

2. Install dependencies:

go mod tidy

3. Run the server:

go run main.go

✨ Features

• Handle JSON messages via standard input and output.
• Comply with the basic data type definitions of the MCP protocol.
• Provide error handling capabilities.

📦 Project Structure

.
├── main.go              # Main server implementation file
├── go.mod              # Go module definition file
└── server/
    └── types.go        # Type definitions for the MCP protocol

💻 Usage Examples

Basic Usage

The following shows the basic structure of the server:

// ServerInfo manages the basic information of the server.
type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

// Server provides the basic functions of the MCP server.
type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

Advanced Usage

The server can be extended with the following features:

Implementing Tools

• Add tools with specific functions.
• Define tool parameters and responses.

Implementing Resources

• Add static/dynamic resources.
• Define resource templates.

Message Handlers

• Implement handlers for specific methods.
• Customize error handling.

📚 Documentation

Main Components

ServerInfo (main.go)

A struct that manages the basic information of the server.

type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

Server (main.go)

A struct that provides the basic functions of the MCP server.

type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

MCP Message Types (server/types.go)

• Request: Represents a request sent by the client.
• Response: Represents a response returned by the server.
• Error: Represents error information.

📄 License

This project is released under the MIT License.