godig 是一个 CLI ** 也是 MCP 服务器，通过 pkg.go.dev API 探索 Go 包和模块：搜索、文档、符号、版本、导入器和漏洞——无论是从你的 shell 还是 AI 代理。

其命令和MCP工具基于一个小型手写目录（internal/spec），并调用输入的go-pkggodev-client。所有操作均为只读，无需认证。

[!提示] 想找一个Go库而不是CLI？使用samber/go-pkggodev-client——驱动godig的类型化 pkg.go.dev 客户端。

🚀 安装

需要Go >= 1.25。参见技能，也要向你的代理注册MCP服务器。

💡 快速开始

全局标志：-o, --output（table 默认，json，raw，md），--base-url， --vuln-base-url（Go 漏洞数据库，默认为https://vuln.go.dev）， --timeout， --log-level（[debug|info|warn|error|off，默认为error;日志归于stderr）。 所有标志也可以通过 GODIG_ 前缀环境变量设置。

退出代码：0 成功，1 运行时错误（例如网络，未找到包），2 使用错误 （缺少/无效的参数或标志，或未调用子命令的组）。

🧠 命令

godig - CLI & MCP server for pkg.go.dev

godig is a CLI and an MCP server for exploring Go packages and modules via the pkg.go.dev API: search, documentation, symbols, versions, importers and vulnerabilities — from your shell or from an AI agent.

Its commands and MCP tools are built from a small hand-written catalog (internal/spec) and call the typed go-pkggodev-client. All operations are read-only and need no authentication.

[!TIP] Looking for a Go library instead of a CLI? Use samber/go-pkggodev-client — the typed pkg.go.dev client that powers godig.

🚀 Install

go install github.com/samber/godig/cmd/godig@latest

# AI Agent Skill:
npx skills add https://github.com/samber/cc-skills-golang --skill golang-pkg-go-dev

# Register the MCP server into Claude Code (stdio)
claude mcp add pkg-go-dev -- godig mcp

Requires Go >= 1.25. See Skill to also register the MCP server with your agent.

💡 Quick start

# Overview — one compact call: metadata, latest + recent versions, licenses, vulns
godig overview github.com/samber/ro

# Search
godig search "result option monad" --limit 5

# Package facets
godig package info github.com/samber/ro
godig package imports github.com/samber/ro
godig package doc github.com/samber/ro --format md
godig package examples github.com/samber/ro
godig package examples github.com/samber/ro --symbol Map   # examples for one symbol only
godig package licenses github.com/samber/ro

# Single symbol (token-efficient vs the full package doc/examples)
godig symbol doc github.com/samber/ro Map
godig symbol examples github.com/samber/mo Either.ForEach

# Module facets
godig module info github.com/samber/ro            # incl. download size + min Go version
godig module readme github.com/samber/ro
godig module licenses github.com/samber/ro
godig dependencies github.com/samber/oops         # go.mod requires/replaces/excludes

# Lists (auto-paginated; --limit to cap, -o md for a Markdown table)