AA

augmnt/augments-mcp-server

Developer tools

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

127 stars 21 forks Качество 70 Тренд 16MIT

augmnt/augments-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/augmnt/augments-mcp-server.

Обзор

augmnt/augments-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/augmnt/augments-mcp-server.

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

Поставщик документации фреймворка следующего поколения для Claude Code с помощью протокола Model Context Protocol (MCP). Возвращает типы + проза + примеры с контекстно-ориентированным форматированием для любого npm-пакета — не только курируемых.

MCP-имя: dev.augments/MCP

Что нового в v7

Версия 7.0 — самое крупное обновление на сегодняшний день: поиск на основе документации, 4 новых инструмента, индексация BM25 и производственная надёжность.

v6 v7
3 инструмента 8 инструментов (+ диагностика)
Поиск только по типам Поиск BM25 в документации
8 синонимов понятий 25 кластеров синонимов концептов
Общие версии различий Реальные изменения, поддерживаемые журналом изменений
Руководства по миграции без Кросс-версии руководств по миграции
Нет диагностики ошибок Отобранные шаблоны ошибок + проблемы на GitHub
Нет сравнения пакетов Сравнение пакетов рядом
Нет сканирования dep Сканер зависимостей (устаревший/устарелый/защищённый)
Кэши FIFO Кэши LRU со статистикой попадания/промаха
Фиксированные задержки повторных попыток Экспоненциальное отключение + автоматический выключатель

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

Код Клода

Курсор

Добавьте к вашей конфигурации MCP:

Переменные среды

Установите GITHUB_TOKEN для более высоких лимитов скорости API GitHub при извлечении примеров и документации:

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

README

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

A next-generation framework documentation provider for Claude Code via Model Context Protocol (MCP). Returns types + prose + examples with context-aware formatting for any npm package — not just curated ones.

mcp-name: dev.augments/mcp

What’s New in v7

Version 7.0 is the biggest upgrade yet — documentation-first search, 4 new tools, BM25 indexing, and production-grade reliability.

v6 v7
3 tools 8 tools (+ diagnostics)
Types-only search Documentation-first BM25 search
8 concept synonyms 25 concept synonym clusters
Generic version diffs Real changelog-backed breaking changes
No migration guides Cross-version migration guides
No error diagnosis Curated error patterns + GitHub Issues
No package comparison Side-by-side package comparison
No dep scanning Dependency scanner (outdated/deprecated/security)
FIFO caches LRU caches with hit/miss stats
Fixed retry delays Exponential backoff + circuit breaker

Quick Start

Claude Code

# Add the MCP server (runs locally via npx)
claude mcp add -s user augments -- npx -y @augmnt-sh/augments-mcp-server

# Verify configuration
claude mcp list

Cursor

Add to your MCP config:

{
  "mcpServers": {
    "augments": {
      "command": "npx",
      "args": ["-y", "@augmnt-sh/augments-mcp-server"]
    }
  }
}

Environment Variables

Set GITHUB_TOKEN for higher GitHub API rate limits when fetching examples and documentation:

{
  "mcpServers": {
    "augments": {
      "command": "npx",
      "args": ["-y", "@augmnt-sh/augments-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Usage

# Get API context with prose + examples (recommended first tool)
@augments get_api_context query="useEffect cleanup" framework="react"

# Natural language queries work great
@augments get_api_context query="how to use zustand middleware"

# Search for APIs by concept (synonym-aware)
@augments search_apis query="state management"

# Get version info with real breaking changes
@augments get_version_info framework="react" fromVersion="18" toVersion="19"

# Migration guide between versions
@augments get_migration_guide package="next" fromVersion="14" toVersion="15"

# Diagnose an error
@augments diagnose_error error="Objects are not valid as a React child" package="react"

# Compare packages side-by-side
@augments compare_packages packages=["zod", "yup", "joi"]

# Scan project dependencies
@augments scan_project_deps

Tools

Tool Description
get_api_context Primary tool. Returns API signatures, prose documentation, and code examples for any npm package. Handles natural language queries with intent detection. Now with documentation-first BM25 search.
Открыть полный README на GitHub

Установка

npx -y @augmnt-sh/augments-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "augments": { "command": "npx", "args": ["-y", "@augmnt-sh/augments-mcp-server"] } } }