SG

samber/godig

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 2 forks Качество 79 Тренд 30MIT

CLI и MCP сервер для pkg.go.dev

Обзор

godig - это CLI-сервер MCP для изучения пакетов и модулей Go через API pkg.go.dev: поиск, документация, символы, версии, импортеры и уязвимости - из вашей оболочки или от агента ИИ. Его команды и инструменты MCP построены из небольшого рукописного каталога (внутренний/специальный) и вызывают типизированный go-pkggodev-клиент. Все операции только для чтения и не требуют аутентификации. Ищете вместо CLI? Используйте samber/go-pkggodev-client — типизированный pkg.go. Разработчик: The Powers Godig Требуется Go = 1,25. См. также Умение регистрировать MCP-сервер с вашим агентом. Глобальные флаги: -o, -output (по умолчанию таблицы, json, raw, md), -base-url, -vuln-base-url (база данных уязвимостей Go, по умолчанию https://vuln.go.dev),), -timeout, -log-level (debug |info |warn |error |off, ошибка по умолчанию; журналы переходят на ). Все флаги также могут быть установлены с помощью переменных среды GODIG . Коды выхода: 0 успеха, 1 ошибка времени выполнения (например.

Обзор (машинный перевод)

godig — это CLI** и MCP-сервер для изучения пакетов и модулей Go через API pkg.go.dev: поиск, документация, символы, версии, импортеры и уязвимости — из вашей оболочки или от агента ИИ.

Его команды и инструменты MCP построены из небольшого рукописного каталога internal/spec и вызывают типизированный go-pkggodev-client. Все операции только для чтения и не требуют аутентификации.

[!TIP] Ищете библиотеку **Go вместо CLI? Используйте samber/go-pkggodev-client — типизированный клиент pkg.go.dev, который питает godig.

###Установка

Требуется Go = 1,25. См. также Умение регистрировать MCP-сервер с вашим агентом.

###Быстрый старт

Мировые флаги: -o, --output table по умолчанию, json, [[T8], md, --base-url, --vuln-base-url (База данных уязвимостей, по умолчанию https://vuln.go.dev), --timeout, --log-level debug|info|warn|error|off, по умолчанию error; журналы переходят на stderr. Все флаги также могут быть установлены с помощью префиксированных переменных среды GODIG_.

Коды выхода: 0 успех, 1 ошибка времени выполнения (например, сеть, пакет не найден), 2 ошибка использования (отсутствующие/недействительные аргументы или флаги, или группа, на которую ссылаются без подкомиссии).

Команды

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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)
Открыть полный README на GitHub

Установка

npx skills add https://github.com/samber/cc-skills-golang --skill golang-pkg-go-dev
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "pkg-go-dev": { "command": "godig", "args": ["mcp"] } } }