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 翻译）
通过模型上下文协议（MCP）为Claude代码提供下一代框架文档。返回类型+散文+示例，且带有上下文感知格式，适用于任意的npm包——而不仅仅是策划的。
MCP 名称：dev.augments/mcp
第七版有什么新内容
7.0版本是迄今为止最大的升级——文档优先搜索，4个新工具，BM25索引功能，以及生产级可靠性。
| V6 | v7 |
|---|---|
| 3个工具 | 8个工具（+ 诊断工具） |
| 仅类型搜索 | 文档优先的 BM25 搜索 |
| 8个概念同义词 | 25个概念同义词簇 |
| 通用版本差异 | 真实的变更日志支持的破坏性变更 |
| 无迁移指南 | 跨版本迁移指南 |
| 无错误诊断 | 精心策划的错误模式 + GitHub 问题 |
| 无包装比较 | 并排包装比较 |
| 没有 DEP 扫描 | 依赖扫描器（过时/弃用/安全） |
| FIFO缓存 | 带有命中/失败统计的LRU缓存 |
| 固定重试延迟 | 指数回撤 + 断路器 |
快速启动
克劳德·科德
光标
添加你的MCP配置：
环境变量
在获取示例和文档时，设置 GITHUB_TOKEN 以获得更高的 GitHub API 速率限制：
本页由 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. |
安装
npx -y @augmnt-sh/augments-mcp-server配置
{
"mcpServers": {
"augments": {
"command": "npx",
"args": ["-y", "@augmnt-sh/augments-mcp-server"]
}
}
}