MCP Gopls

🚀 MCP-GOPLS

MCP-GOPLS 是一個 MCP（模型上下文協議）服務器，它封裝了 gopls 以提供 Go 語言服務器功能。

🚀 快速開始

MCP-GOPLS 是一個封裝了 gopls 的 MCP 服務器，能為你提供 Go 語言服務器功能。不過需要注意的是，整個項目由 Claude Code 生成，未經過人工代碼審查。雖然它通過了測試且看起來功能正常，但在生產環境中請務必極度謹慎使用。代碼尚未進行安全性、性能或邊緣情況的審計。你可以查看 DESIGN.md 瞭解 AI 生成的設計文檔。

✨ 主要特性

目前已實現所有 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 許可證。

⚠️ 重要提示

整個項目由 Claude Code 生成，未經過人工代碼審查。雖然它通過了測試且看起來功能正常，但在生產環境中請務必極度謹慎使用。代碼尚未進行安全性、性能或邊緣情況的審計。

💡 使用建議

建議在使用前仔細閱讀 DESIGN.md 瞭解 AI 生成的設計文檔，同時在開發過程中按照開發步驟進行操作，以確保項目的正常運行。