MCP Gopls

🚀 MCP - GOPLS

MCP（モデルコンテキストプロトコル）サーバーで、goplsをラップしてGo言語サーバーの機能を提供します。

⚠️ 重要な注意

このプロジェクト全体はClaude Codeによって生成され、人によるコードレビューは行われていません。テストをパスし、機能しているように見えますが、本番環境では極めて注意して使用してください。コードはセキュリティ、パフォーマンス、エッジケースについて監査されていません。AIによって生成された設計文書についてはDESIGN.mdを参照してください。

✨ 主な機能

すべてのgopls言語サーバーの機能が実装されています：

• GoToDefinition：シンボルの定義に移動します
• FindReferences：シンボルのすべての参照を検索します
• GetDiagnostics：コンパイルエラーと静的解析の結果を取得します
• Hover：カーソル下のシンボルに関する情報を取得します
• SearchSymbol：ワークスペース全体でシンボルを検索します（部分一致をサポート）
• RenameSymbol：ワークスペース全体でシンボルをリネームします（変更を直接ファイルに適用）
• FindImplementers：インターフェースを実装するすべての型を検索します
• ListDocumentSymbols：ファイル内で定義されたシンボルのアウトラインを取得します
• FormatCode：gofmt標準に従ってGoソースコードをフォーマットします（変更をファイルに適用）
• OrganizeImports：インポート文を整理します（インポートをグループ化してソートし、変更をファイルに適用）

📦 インストール

go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest

Claudeとの統合

Claude Code

1. mcp - goplsをインストールします：

   go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest
   

2. Claude Codeに追加します：

   claude mcp add mcp-gopls "$(which mcp-gopls)"
   

3. Claude Codeを再起動します：

   claude restart
   

4. インストールを確認します：

   claude mcp list
   

Claude Desktop

1. mcp - goplsをインストールします（上記と同じ）

2. Claude Desktopの設定を編集します：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. mcpServersセクションに以下を追加します：

   {
     "mcpServers": {
       "mcp-gopls": {
         "command": "mcp-gopls",
         "args": []
       }
     }
   }
   

   または、カスタムワークスペースを使用する場合：

   {
     "mcpServers": {
       "mcp-gopls": {
         "command": "mcp-gopls",
         "args": ["-workspace", "/path/to/your/go/project"]
       }
     }
   }
   

4. Claude Desktopを再起動します

💻 使用例

基本的な使用法

# デフォルト設定で実行（PATH内のgoplsを使用し、現在のディレクトリをワークスペースとして使用）
mcp-gopls

# goplsのパスとワークスペースを指定
mcp-gopls -gopls /path/to/gopls -workspace /path/to/project

# 環境変数を使用
export GOPLS_PATH=/path/to/gopls
export MCP_GOPLS_WORKSPACE=/path/to/project
mcp-gopls

📚 詳細ドキュメント

必要条件

• Go 1.24.3以上
• gopls（Go言語サーバー）

goplsのインストール

go install golang.org/x/tools/gopls@latest

開発方法

# リポジトリをクローン
git clone https://github.com/yantrio/mcp-gopls
cd mcp-gopls

# プロジェクトをビルド
go build ./cmd/mcp-gopls

# テストを実行
go test ./...

📄 ライセンス

MIT