augmnt/augments-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

127 stars 20 forks 품질 70 트렌드 16MIT

Repository Install

augmnt/augments-mcp-server는 https://github.com/augmnt/augments-mcp-server.에서 가져온 MCP 서버 후보입니다.

개요

augmnt/augments-mcp-server는 https://github.com/augmnt/augments-mcp-server.에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

Model Context Protocol(MCP)을 통한 차세대 Claude Code 프레임워크 문서 제공자입니다. types + prose + examples를 **모든 npm 패키지에 대해 문맥 인식 서식으로 반환합니다 — 단순히 큐레이션된 패키지뿐만 아니라.

MCP-이름: dev.augments/mcp

v7의 새로운 소식

버전 7.0은 지금까지 중 가장 큰 업그레이드입니다 — 문서 우선 검색, 4개의 새로운 도구, BM25 인덱싱, 그리고 생산용 수준의 신뢰성.

V6	V7
3개의 도구	8개의 도구 (+ 진단)
유형 전용 검색	문서 우선 BM25 검색
8 개념 동의어	25 개념 동의어 클러스터
일반 버전 차이점	실제 변경 로그에 기반한 변경 사항
마이그레이션 가이드 없음	크로스 버전 마이그레이션 가이드
오류 진단 없음	엄선된 오류 패턴 + GitHub 문제
패키지 비교 없음	나란히 비교
DEP 스캔 없음	의존성 스캐너 (구식/폐기/보안)
FIFO 캐시	히트/미스 스탯이 포함된 LRU 캐시
고정 재시도 지연	지수 백오프 + 차단기

퀵 스타트

클로드 코드

커서

MCP 설정에 추가:

환경 변수

예제와 문서를 가져올 때 더 높은 GitHub API 속도 제한을 위해 GITHUB_TOKEN를 설정하세요:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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.

GitHub에서 전체 README 보기

설치

npx -y @augmnt-sh/augments-mcp-server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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