快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

docker run -d -p 8080:8080 \

详细介绍

Go标准MCP服务器

中文文档 |英语

用于智能Go代码质量分析的模型上下文协议（MCP）服务，将行业标准linter与自定义规则引擎集成在一起。

特性

MCP协议：与Claude Desktop和其他MCP客户端无缝集成
双重分析模式：完整存储库扫描或基于Git的增量检测
自定义规则：上传和管理团队特定的编码标准
多用户就绪：专为隔离用户上下文的共享部署而设计
CLI+服务器：灵活的部署选项

快速开始

先决条件

转到1.21+
golangci lint（可选，用于增强分析）

安装

# Build both server and CLI
make build-all

# Or build separately
make build-server  # MCP server
make build-cli     # Standalone CLI tool

MCP服务器设置

配置Claude桌面(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "go-standards": {
      "command": "D:\\path\\to\\bin\\mcp-server.exe",
      "args": []
    }
  }
}

CLI使用情况

# Full analysis
go-standards-cli --path ./myproject

# Incremental analysis (Git changes only)
go-standards-cli --path ./myproject --incremental

# Custom config
go-standards-cli --path ./myproject --config rules.yaml

使用指南

1.全代码分析

使用默认设置分析整个Go项目：

使用MCP客户端（克劳德桌面）：

Please analyze the Go code at /path/to/project using analyze_go_code tool

使用CLI：

go-standards-cli --path /path/to/project

使用特定的过梁：

{
  "path": "/path/to/project",
  "mode": "full",
  "linters": ["golangci-lint", "govet"]
}

预期产量：

按严重程度（错误、警告、信息）列出的问题计数
包含文件位置和行号的详细问题列表
建议的修复和最佳实践
总体质量得分

2.Git增量分析

只分析Git中已更改的文件，对于大型项目来说要快得多。

2.1快速检查项目是否为Git仓库

# Using CLI
go-standards-cli --path /path/to/project --git-check

# Or use git_check tool in MCP

答复：

{
  "is_git_repo": true,
  "path": "/path/to/project",
  "message": "This is a valid Git repository"
}

2.2启用Git集成

步骤1：为您的项目启用Git集成

# Using CLI
go-standards-cli --path /path/to/project --git-enable

# Or use git_config tool in MCP with action="enable"

这创建了一个 .go-standards.json 项目根目录中的配置文件：

{
  "enabled": true,
  "auto_commit": false,
  "auto_push": false,
  "base_branch": "origin/main",
  "fail_on_error": true,
  "hooks_installed": false
}

步骤2：配置Git集成（可选）

# Set base branch for comparison
go-standards-cli --path /path/to/project --git-config \
  --base-branch main

# Configure via git_config tool

完整配置选项：

{
  "action": "set",
  "path": "/path/to/project",
  "config": {
    "enabled": true,
    "base_branch": "main",
    "auto_commit": true,
    "auto_push": false,
    "config_file": ".golangci.yml",
    "fail_on_error": true
  }
}

2.3运行增量分析

分析暂存文件（提交前）：

go-standards-cli --path /path/to/project --incremental --mode staged

分析修改的文件（工作目录）：

go-standards-cli --path /path/to/project --incremental --mode modified

分析从分支更改的文件：

go-standards-cli --path /path/to/project --incremental \
  --mode branch --base main

使用MCP工具：

{
  "path": "/path/to/project",
  "mode": "incremental",
  "linters": ["golangci-lint"]
}

2.4安装Git钩子（提交/推送时自动检查）

# Install pre-commit hook
go-standards-cli --path /path/to/project --install-hooks commit

# Install pre-push hook
go-standards-cli --path /path/to/project --install-hooks push

# Install both
go-standards-cli --path /path/to/project --install-hooks all

安装后，当您执行以下操作时，该工具将自动运行：

git commit -检查暂存文件
git push -检查从基本分支更改的文件

挂钩行为：

通过：如果没有问题，提交/推送正常进行
失败：如果发现问题，提交/推送将被阻止，并显示问题
配置 fail_on_error: false 允许带有警告的提交

3.自定义编码标准

上传团队的编码标准并自动生成linter配置。

3.1上传标准文档

支持的格式： PDF、Markdown、文本

# Using CLI
go-standards-cli --upload-document /path/to/team-standard.pdf \
  --name "team-v1" \
  --description "Company Go coding standards v1.0"

# Using MCP upload_document tool

发生了什么：

文档被解析和分析
规则会自动提取
.golangci.yml 配置已生成
配置已保存到 storage/shared/configs/

3.2使用自定义标准进行分析

go-standards-cli --path /path/to/project --config team-v1

3.3列出可用标准

go-standards-cli --list-standards

# Or use list_standards MCP tool

输出：

Available Coding Standards:
1. strict - Highest standards (complexity ≤ 5, coverage ≥ 85%)
2. standard - Balanced standards (complexity ≤ 10, coverage ≥ 70%)
3. relaxed - Basic standards (complexity ≤ 15, coverage ≥ 60%)
4. team-v1 - Company Go coding standards v1.0

4.高级配置

4.1定制过梁配置

创建 .golangci.yml 在项目根目录中：

linters:
  enable:
    - gofmt
    - golint
    - govet
    - errcheck
    - staticcheck
    - gosec
  
linters-settings:
  gocyclo:
    min-complexity: 10
  govet:
    check-shadowing: true
  errcheck:
    check-type-assertions: true

issues:
  exclude-rules:
    - path: _test\.go
      linters:
        - gocyclo

4.2多项目批量分析

# Analyze multiple projects
go-standards-cli --batch \
  --projects "project1,project2,project3" \
  --output batch-report.json

4.3 CI/CD集成

GitHub操作示例：

name: Code Quality Check

on: [push, pull_request]

jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Install go-standards
        run: |
          wget https://github.com/MOONL0323/go-standards-mcp-server/releases/latest/download/go-standards-cli
          chmod +x go-standards-cli
      
      - name: Run analysis
        run: |
          ./go-standards-cli --path . --incremental --mode branch --base origin/main

GitLab CI示例：

code_quality:
  script:
    - go-standards-cli --path . --incremental
  only:
    - merge_requests

建筑

flowchart TB
    subgraph Clients[MCP Clients Layer]
        Claude[Claude Desktop]
        VSCode[VS Code Extension]
        Other[Other MCP Clients]
    end

    subgraph Server[Go Standards MCP Server]
        direction TB
        
        subgraph Protocol[MCP Protocol Layer]
            Tools[MCP Tools: analyze_go_code, git_check/config, list_standards, upload_document, get/set_config]
            Resources[Resources: standards, configs]
        end

        subgraph Service[Service Layer]
            Analyzer[Analyzer Engine]
            DocService[Document Service]
            GitDetector[Git Detector]
            ConfigMgr[Config Manager]
            StorageMgr[Storage Manager]
            SessionMgr[Session Manager]
        end

        subgraph Linters[Linter Integration]
            Golangci[golangci-lint]
            GoVet[go vet]
            StaticCheck[staticcheck]
        end
    end

    subgraph Storage[Storage Layer]
        Shared[Shared: checklists, configs, templates]
        UserData[User Isolated: history, settings, reports]
    end

    Claude -->|stdio| Protocol
    VSCode -->|stdio| Protocol
    Other -->|http/sse| Protocol

    Protocol --> Service
    Service --> Linters
    Service --> Storage

    classDef serverStyle fill:#e1f5ff,stroke:#0288d1,stroke-width:2px
    classDef protocolStyle fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    classDef serviceStyle fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    classDef linterStyle fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    classDef storageStyle fill:#fce4ec,stroke:#c2185b,stroke-width:2px

    class Server serverStyle
    class Protocol protocolStyle
    class Service serviceStyle
    class Linters linterStyle
    class Storage storageStyle

架构组件：

MCP协议层：8个用于代码分析、git集成和配置管理的工具
服务层：具有并行执行、缓存和会话管理的核心业务逻辑
林特尔集成：golangci lint（40+跳棋），去兽医，统计检查
存储层：共享资源和用户隔离数据，会话超时30分钟

MCP工具

`analyze_go_code`

使用可配置的linter和规则分析Go代码。

参数：

path （必填）：目标目录
mode （可选）： "full" 或 "incremental" （默认值： "full")
linters （可选）：例如。， ["golangci-lint", "govet"]
config （可选）：自定义配置文件路径

例子：

{
  "path": "/path/to/project",
  "mode": "incremental",
  "linters": ["golangci-lint"]
}

`git_check`

快速检查路径是否为Git存储库。

`list_standards`

列出所有可用的编码标准文件。

`upload_document`

上传团队编码标准（PDF/Markdown）。

参数：

file_path：文档路径
doc_type: "checklist" 或 "guideline"
language: "go", "python"等等。

`get_config` / `set_config`

获取或更新Git集成配置。

配置

Git集成(`.go-standards-git.yaml`)

git_integration:
  enabled: true
  base_branch: "main"
  ignored_paths:
    - "vendor/"
    - "*.pb.go"
  max_file_size_kb: 500

分析配置

linters:
  golangci:
    enabled: true
    config_file: ".golangci.yml"
  govet:
    enabled: true

rules:
  max_function_lines: 100
  require_comments: true

多用户部署

存储结构：

storage/
├─ shared/              # Shared resources
│   ├─ checklists/      # Team standards
│   └─ configs/         # Default configs
└─ users/{userID}/      # User-isolated data (future)
    ├─ history/
    └─ settings/

Docker：

docker build -t go-standards-mcp .
docker run -d -p 8080:8080 \
  -v /path/to/storage:/app/storage \
  go-standards-mcp

发展

make test    # Run tests
make lint    # Lint code
make fmt     # Format code
make help    # View commands

常见问题解答

Q：如何使用增量分析？\ A：确保您的项目是Git存储库，然后使用 "mode": "incremental" 或 --incremental 旗帜。

Q：我可以使用自定义编码标准吗？\ A：是的，使用 upload_document 上传团队特定标准。

Q：多语言支持？\ A：目前专注于Go。框架支持扩展。

Q：多用户部署？\ A：使用带有持久存储的Docker/Kubernetes。用户隔离架构已准备就绪（请参阅 internal/usercontext/).

许可证

MIT许可证-请参阅许可证

目录标签

代码分析代码质量GoClaude静态分析本地部署Go语言Git集成

支持客户端

Claude DesktopClaudeVS Code

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

session

运行时（runtime，运行环境）

Docker

工具数量（toolCount，工具数）

5

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdiosession部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/f0efc559a50f177f3bf8659bc9489a34

一个基于MCP协议的智能Go代码质量分析服务，支持全量扫描和Git增量检测，可集成自定义编码规范。

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

gossiphs (Williamfzc)

全面解析GossiphsMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Gossiphs能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

下一个 MCP

Go Streamablehttp MCP Demo

帮助用户高效构建MCP服务器和客户端的开发工具，支持在/common/tools和/common/resources目录中添加工具和资源。

Go Standards MCP Server