MCP Go Tools

🚀 MCP-GO Tool Project Documentation

MCP-GO Tool is a Model Context Protocol (MCP) server based on the Go language. It offers Go-style code generation, style guides, and best practices, aiming to assist language models in more efficiently understanding and generating high-quality Go code, following established patterns and conventions.

🚀 Quick Start

MCP-GO Tool is a powerful utility designed to streamline the process of working with the Model Context Protocol (MCP) in the Go programming language. It provides a set of tools and libraries that simplify the implementation of MCP servers and clients, allowing developers to focus on their application logic rather than the underlying protocol details.

✨ Features

Main Features

1. Go Code Generation: Supports template-based code generation to ensure code quality.
2. Style Guide Integration: Provides code style checking and adjustment in line with Go style.
3. Cobra CLI Support: Utilizes the popular Go command-line framework with a clear command structure.
4. Configuration Management: Supports configuration files in YAML/JSON format for easy customization of tool behavior.
5. Logging: Implements structured logging using the slog library, supporting multiple output formats and log levels.
6. Server Management: Offers a rich set of server management commands and supports signal handling.

Project Architecture

The MCP-GO Tool adheres to the Clean Architecture design principle and is divided into the following layers:

1. API Layer: Responsible for MCP protocol communication, server lifecycle management, and API interface definition.
2. Core Logic Layer: Handles key business logic such as code pattern recognition and style rule management.
3. Repository Layer: Manages data templates and configuration files, providing persistent support.
4. Command-Line Layer: Implements CLI commands, responsible for parameter parsing and command execution.

📦 Installation

To install the MCP-GO Tool, run the following command:

go install -o mcp-go-tools ./cmd/mcp-go-tools

📚 Documentation

MCP Protocol

This project uses the github.com/metoro-io/mcp-golang library to implement the MCP protocol. The server implements the following functions:

• stdio Transmission: Communicates through standard input and output.
• Graceful Shutdown: Supports graceful shutdown of the server to ensure no data loss.
• Concurrent Processing: Utilizes the golang.org/x/sync package in Go to handle concurrent requests.
• Code Generation Tool: Provides Go-specific code generation capabilities.

Configuration Guide

Global Flags

• --config: Specifies the path to the configuration file, defaulting to config.yaml in the current directory.
• --log-level: Sets the log level, with optional values including debug, info, warning, error, defaulting to info.
• --log-format: Specifies the log output format, supporting json and plain, defaulting to plain.
• --log-file: Specifies the path to the log file, defaulting to standard output.

Configuration File Example

# Basic Configuration
global:
  log_level: info
  log_format: plain
  log_file: ./mcp-go.log

# Server Configuration
server:
  host: "127.0.0.1"
  port: 8080

# Other Custom Configurations
custom:
  enable_cache: true
  cache_timeout: 3600

Project Structure

The project's directory structure is as follows:

.
├── cmd/
│   └── mcp-go-tools/
│       ├── main.go        # Main program entry
│       └── command/      # Individual command implementations
├── core/
│   └── code_generator.go  # Core code generation logic
└── repo/
    └── template.go         # Template management and loading

Dependencies

• Go Version: 1.23.4 or higher
• MCP Protocol Implementation: github.com/metoro-io/mcp-golang
• Command-Line Framework: github.com/spf13/cobra
• Configuration Management: github.com/spf13/viper
• Synchronization and Concurrency: golang.org/x/sync

Development Guide

Contributing Code

If you wish to contribute to the MCP-GO Tool, please follow these steps:

1. Fork the project to your GitHub account.
2. Create a feature branch and submit code changes.
3. Submit a Pull Request to the original project.

Issue Feedback

If you encounter any issues or find bugs, please submit an issue report in the Issues section of the GitHub repository.

💻 Usage Examples

Starting the Server

mcp-go-tools server --config ./config.yaml

Configuring Log Output

# Output to a file using JSON format
mcp-go-tools server --log-file /var/log/mcp-go.log --log-format json

Integration into the Cline Toolchain

To use the MCP-GO Tool in the Cline toolchain, you can configure it as follows:

{
  "mcp-go": {
    "host": "localhost",
    "port": 8080,
    "config": "./config.yaml"
  }
}

📄 License

The MCP-GO Tool is licensed under the MIT License, allowing users to freely use, modify, and distribute the code.