
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
接入你的智能体
發布者自己的 URL。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
https://mcp.augments.dev/mcp上方的 Claude 按鈕會開啟 Claude,並填好名稱和 URL。你仍需在那裡確認。
claude mcp add --transport http dev.augments-mcp https://mcp.augments.dev/mcpRun in a terminal.
{ "mcpServers": { "dev.augments-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.augments.dev/mcp" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者

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
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Version 7.0 is the biggest upgrade yet — documentation-first search, 4 new tools, BM25 indexing, and production-grade reliability.
# 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
Add to your MCP config:
{
"mcpServers": {
"augments": {
"command": "npx",
"args": ["-y", "@augmnt-sh/augments-mcp-server"]
}
}
}
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"
}
}
}
}
# 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
flowchart TD
A["Query: 'how to use useEffect cleanup'"] --> B
B["Intent Detection → howto<br/>Query Parser → react / useEffect"]
B --> C["Type Fetcher<br/>CDN racing · npm metadata · @types"]
B --> D["Doc Fetcher<br/>GitHub API · BM25 search · 25 synonym clusters"]
B --> E["Example Extractor<br/>GitHub docs · README fallback · Auto-discovery"]
C --> F["Type Parser<br/>Signatures · Parameters · Related types"]
D --> G["Doc Search Engine<br/>BM25 indexing · Heading-based chunks · API boost"]
F --> H["Intent-Driven Formatter (howto)<br/>→ Examples first, prose, brief signature<br/>→ ~500-2000 tokens, 10KB max"]
G --> H
E --> H
src/
├── cli.ts # stdio entry point
├── server.ts # MCP server (8 tools + diagnostics)
├── core/ # Core modules
│ ├── query-parser.ts # Parse natural language → framework + concept
│ ├── type-fetcher.ts # Fetch .d.ts + README from npm/unpkg/jsdelivr
│ ├── type-parser.ts # Parse TypeScript, extract signatures, synonym search
│ ├── example-extractor.ts # Fetch examples from GitHub docs + auto-discovery
│ ├── version-registry.ts # npm registry integration + changelog-backed diffs
│ ├── doc-fetcher.ts # GitHub documentation fetcher
│ ├── doc-search.ts # BM25 inverted index search engine
│ ├── changelog-fetcher.ts # CHANGELOG.md + GitHub Releases parser
│ ├── type-differ.ts # .d.ts diff between versions
│ └── error-patterns.ts # Curated error pattern database
├── tools/v4/ # MCP tools
│ ├── get-api-context.ts # Primary tool (types + docs + examples)
│ ├── search-apis.ts # Cross-framework API search
│ ├── get-version-info.ts # Version comparison
│ ├── get-migration-guide.ts # Cross-version migration guides
│ ├── diagnose-error.ts # Error diagnosis
│ ├── compare-packages.ts # Package comparison
│ └── scan-project-deps.ts # Dependency scanner
└── utils/
├── logger.ts # stderr logger
└── lru-cache.ts # Generic LRU cache with stats
Queries like "prisma findMany with pagination" and "zustand create store with middleware" now return real documentation content. The BM25 search engine indexes docs fetched from GitHub by heading-based chunks, with API name boosting and synonym expansion.
25 synonym clusters cover state, form, fetch, animation, routing, auth, cache, effect, middleware, pagination, validation, testing, streaming, error handling, database, layout, modal, table, upload, realtime, deployment, i18n, SSR, component, and context patterns. Bidirectional lookup means "usestate" expands to the "state" cluster.
Every npm package is supported out of the box — no curation or configuration needed. Augments resolves documentation automatically through four layers:
"types" in package.json) or DefinitelyTyped (@types/*)repository field, finds the GitHub repo, probes docs/ directoriesREADME.mdThis means augments works with the entire npm ecosystem (~2.5M packages), not just a curated subset.
22 frameworks have curated doc sources for richer examples: React, Next.js, Vue, Prisma, Zod, Supabase, TanStack Query, tRPC, React Hook Form, Framer Motion, Express, Zustand, Jotai, Drizzle, SWR, Vitest, Playwright, Fastify, Hono, Solid, Svelte, Angular, Redux
Special sub-module resolution for: React Hook Form, TanStack Query, Zustand, Jotai, tRPC, Drizzle ORM, Next.js
# Clone and install
git clone https://github.com/augmentscode/augments-mcp-server.git
cd augments-mcp-server
npm install
# Build with tsup
npm run build
# Run locally
npm start
# Watch mode
npm run dev
# Run tests
npm test
# Run e2e tests (real network calls)
npm run test:e2e
# Type check
npm run type-check
git checkout -b feature/amazing-featurenpm testMIT License - see LICENSE for details.
Built for the Claude Code ecosystem | Version 7.0.0
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
{ "mcpServers": { "dev.augments-mcp": { "url": "https://mcp.augments.dev/mcp", "headers": {} } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 http 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Augments 透過 HTTP 存取。
上次檢查時間:2026-11-08。 Augments MCP Server - A comprehensive framework documentation provider for Claude Code