Go MCP Server Service

🚀 Go-based MCP Server (notes-server)

This is a server compliant with the JSON-RPC 2.0 standard, demonstrating note management following the Model Context Protocol (MCP) through examples. It serves as a template that you can modify and use in your own projects. It supports cross - platform development and includes configurations for development and release builds, a command - line interface, and service components.

🚀 Quick Start

This server is an example implementation of note management following the Model Context Protocol (MCP) with JSON - RPC 2.0 standard. You can modify it and use it as a template for your own projects.

✨ Features

• JSON - RPC 2.0 standard interface
• Cross - platform support (Windows, Linux, macOS)
• Thread - safe note management
• Development and release build configurations
• Service and command - line interface components

📚 Documentation

Component Modules

Command - Line Interface (cmd)

The command - line interface provides direct access to the server's functionality.

Service (service)

The service component enables system - level integration and background operation.

Resource Management

The server implements a note storage system, including:

• A custom note:// URI scheme for accessing individual notes
• Resource metadata (name, description, MIME type)
• Thread - safe concurrent access

Prompt Function

Available prompt commands:

• summarize - notes: Create a summary of all stored notes
  • Optional parameter: style ("concise"/"detailed")
  • Combine all current notes according to style preferences
  • Thread - safe note access

Tool Function

Available tool commands:

• add - note: Add a new note to the server
  • Required parameters: name (string), content (string)
  • Thread - safe status update
  • Return a confirmation message

Build Instructions

Prerequisites

• Go 1.21 or higher
• GNU Make or a compatible build tool
• Git (for version information)

Build Commands

Development build (with debug symbols and race detection):

# Build all components for all platforms
make dev

# Build for a specific platform
make dev - windows
make dev - linux
make dev - darwin

# Build a specific component
make build - cmd
make build - service

Release build (optimized and stripped of symbols):

# Build all components for all platforms
make release - all

# Build for a specific platform
make release - windows
make release - linux
make release - darwin

Run locally:

# Run the command - line interface
make run - cmd

# Run the service
make run - service

View all target options:

make help

Build Output

Binary files will be created in the bin directory:

• Development build: bin/dev/
• Release build: bin/release/

Configuration Guide

Configuration for Claude Desktop

To configure via the command - line interface, run the following commands:

# Set the MCP address
export MCP_ADDR="http://localhost:8080"

# Set the MCP authentication token
export MCP_TOKEN="your_token_here"

Development Guide

Project Structure

The project's folder structure is as follows:

notes - server/
├── cmd/
│   ├── main.go         # Command - line entry point
│   └── service.go      # Service implementation
├── internal/
│   ├── handlers/       # Request handling logic
│   └── models/         # Data model definitions
└── go.mod              # Module dependency management file

Debugging and Logging

To enable debug mode, set the environment variable at runtime:

# Enable debug mode
export DEBUG=true

By default, the service outputs logs to the standard error stream.

Error Code Definitions

The following are the error codes returned by the MCP service:

Important Note

⚠️ Important Note

• In a production environment, ensure that appropriate firewalls and security policies are set up.
• Manage sensitive information using environment variables to avoid hard - coding.
• Regularly back up data to prevent accidental loss.