MCP Go Tools

🚀 MCP-GO 工具項目文檔翻譯

MCP-GO 工具是一個基於 Go 語言的模型上下文協議（MCP）服務器，能助力語言模型更高效地理解和生成高質量的 Go 代碼，遵循既定的模式和慣例。

🚀 快速開始

MCP-GO 工具是一款強大的基於 Go 語言的 MCP 服務器，它提供了符合 Go 風格的代碼生成、樣式指南和最佳實踐，能幫助語言模型更好地理解和生成高質量的 Go 代碼。

✨ 主要特性

1. Go 代碼生成：支持基於模板的代碼生成，確保代碼質量。
2. 樣式指南集成：提供符合 Go 風格的代碼樣式檢查和調整。
3. Cobra CLI 支持：使用流行的 Go 命令行框架，命令結構清晰。
4. 配置管理：支持 YAML/JSON 格式的配置文件，便於定製工具行為。
5. 日誌記錄：採用 slog 庫實現結構化日誌，支持多種輸出格式和日誌級別。
6. 服務器管理：提供豐富的服務器管理命令，並支持信號處理。

📦 安裝指南

要安裝 MCP-GO 工具，請運行以下命令：

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

💻 使用示例

基礎用法

啟動服務器

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

配置日誌輸出

# 輸出到文件，使用 JSON 格式
mcp-go-tools server --log-file /var/log/mcp-go.log --log-format json

高級用法

集成到 Cline 工具鏈

要在 Cline 工具鏈中使用 MCP-GO 工具，可以按照以下方式進行配置：

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

📚 詳細文檔

MCP 協議

該項目使用了 github.com/metoro-io/mcp-golang 庫來實現 MCP 協議。服務器實現了以下功能：

• stdio 傳輸：通過標準輸入輸出進行通信。
• 優雅關閉：支持服務器的優雅關閉，確保無數據丟失。
• 併發處理：利用 Go 的 golang.org/x/sync 包處理併發請求。
• 代碼生成工具：提供特定於 Go 的代碼生成功能。

項目架構

MCP-GO 工具遵循 Clean Architecture 設計原則，分為以下幾層：

1. API 層：負責 MCP 協議的通信、服務器生命週期管理和 API 接口定義。
2. 核心邏輯層：處理代碼模式識別、樣式規則管理等關鍵業務邏輯。
3. 倉庫層：管理數據模板和配置文件，提供持久化支持。
4. 命令行層：實現 CLI 命令，負責參數解析和命令執行。

配置指南

全局標誌

• --config：指定配置文件路徑，默認為當前目錄下的 config.yaml。
• --log-level：設置日誌級別，可選值包括 debug、info、warning、error，默認為 info。
• --log-format：指定日誌輸出格式，支持 json 和 plain，默認為 plain。
• --log-file：指定日誌文件路徑，默認為標準輸出。

配置文件示例

# 基本配置
global:
  log_level: info
  log_format: plain
  log_file: ./mcp-go.log

# 服務器配置
server:
  host: "127.0.0.1"
  port: 8080

# 其他自定義配置
custom:
  enable_cache: true
  cache_timeout: 3600

項目結構

項目的目錄結構如下：

.
├── cmd/
│   └── mcp-go-tools/
│       ├── main.go        # 主程序入口
│       └── command/      # 各自的命令實現
├── core/
│   └── code_generator.go  # 核心代碼生成邏輯
└── repo/
    └── template.go         # 模板管理與加載

依賴項

• Go 版本：1.23.4 或更高版本
• MCP 協議實現：github.com/metoro-io/mcp-golang
• 命令行框架：github.com/spf13/cobra
• 配置管理：github.com/spf13/viper
• 同步與併發：golang.org/x/sync

開發指南

貢獻代碼

如果您希望為 MCP-GO 工具貢獻力量，請參考以下步驟：

1. Fork 該項目到您的 GitHub 賬戶。
2. 創建功能分支，提交代碼更改。
3. 提交 Pull Request 到原項目。

問題反饋

如遇任何問題或發現 bug，請在 GitHub 倉庫 Issues 區提交問題報告。

📄 許可證

MCP-GO 工具遵循 MIT 許可證，允許用戶自由使用、修改和分發代碼。