MCP Go Tools

🚀 MCP-GO ツールプロジェクトドキュメント翻訳

MCP-GO ツールは、Go 言語に基づくモデルコンテキストプロトコル（MCP）サーバーです。Go スタイルのコード生成、スタイルガイド、およびベストプラクティスを提供し、言語モデルがより効率的に Go コードを理解し、高品質な Go コードを生成するのを支援します。これは established patterns and conventions に従っています。

📚 MCP プロトコル

このプロジェクトでは、github.com/metoro-io/mcp-golang ライブラリを使用して MCP プロトコルを実装しています。サーバーは以下の機能を実装しています。

• stdio 伝送：標準入出力を介した通信を行います。
• エレガントなシャットダウン：サーバーのエレガントなシャットダウンをサポートし、データの損失を防ぎます。
• 並行処理：Go の golang.org/x/sync パッケージを利用して並行リクエストを処理します。
• コード生成ツール：Go 固有のコード生成機能を提供します。

📦 インストール

MCP-GO ツールをインストールするには、以下のコマンドを実行してください。

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

✨ 主な機能

主要特性

1. Go コード生成：テンプレートベースのコード生成をサポートし、コード品質を保証します。
2. スタイルガイド統合：Go スタイルに沿ったコードスタイルのチェックと調整を提供します。
3. Cobra CLI サポート：人気のある Go コマンドラインフレームワークを使用し、コマンド構造が明確です。
4. 設定管理：YAML/JSON 形式の設定ファイルをサポートし、ツールの動作をカスタマイズしやすくします。
5. ログ記録：slog ライブラリを使用して構造化ログを実装し、複数の出力形式とログレベルをサポートします。
6. サーバー管理：豊富なサーバー管理コマンドを提供し、シグナル処理をサポートします。

プロジェクトアーキテクチャ

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

💻 使用例

サーバーの起動

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

ログ出力の設定

# ファイルに出力し、JSON 形式を使用する
mcp-go-tools server --log-file /var/log/mcp-go.log --log-format json

Cline ツールチェーンへの統合

MCP-GO ツールを Cline ツールチェーンに統合するには、以下のように設定できます。

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

📂 プロジェクト構造

プロジェクトのディレクトリ構造は以下の通りです。

.
├── 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. このプロジェクトをあなたの GitHub アカウントに Fork します。
2. 機能ブランチを作成し、コードの変更をコミットします。
3. 元のプロジェクトに Pull Request を送信します。

問題の報告

問題やバグを発見した場合は、GitHub リポジトリの Issues セクションに問題報告を投稿してください。

📄 ライセンス

MCP-GO ツールは MIT ライセンスに従っており、ユーザーはコードを自由に使用、変更、および配布することができます。