增强功能MCP服务器

Name: 增强功能MCP服务器
Author: augmnt

作者：augmnt81 星标更新：2025-11-11

安装使用来源：spider==github.com

项目介绍

这是一个通过模型上下文协议（MCP）为Claude Code提供全面框架文档的框架。它提供了实时访问框架文档、上下文感知帮助以及智能缓存功能，以增强开发工作流程。

mcp-name: dev.augments/mcp

🚀 概述

Augments MCP Server 是一个复杂的文档检索系统，与 Claude Code 集成，提供全面且最新的框架信息。它具有高级缓存策略、多源文档聚合和智能上下文增强功能，适用于现代开发工作流程。

✨ 关键特性

🎯 全面框架支持

分类框架注册表：Web、后端、移动、AI/ML、设计和工具
多源文档：GitHub 存储库、官方网站和示例
热重载配置：动态框架更新无需重启服务器
智能优先级：基于框架重要性的排名

⚡ 高级缓存系统

基于 TTL 的策略：不同版本（稳定版/测试版/开发版）有不同的缓存时长
多层次缓存：内存和磁盘持久化以实现最佳性能
智能失效：根据源更新自动刷新缓存
缓存分析：详细的统计信息和性能监控

🧠 上下文增强

多框架上下文：结合多个框架的文档
代码兼容性分析：检测框架兼容性问题
模式识别：常见使用模式和最佳实践
任务特定指导：针对开发任务的上下文定制

🔧 开发者体验

9 种全面的 MCP 工具：涵盖完整的文档生命周期
结构化响应：干净、验证过的 JSON 输出
错误恢复能力：带有详细错误消息的优雅降级
异步性能：整个操作非阻塞

🏗️ 架构

目录结构

src/augments_mcp/
├── registry/                   # 框架注册管理
│   ├── manager.py             # 热重载注册管理器
│   ├── models.py              # Pydantic 数据模型
│   └── cache.py               # 高级缓存系统
├── tools/                      # MCP 工具实现
│   ├── framework_discovery.py # 框架搜索和列表
│   ├── documentation.py       # 文档检索
│   ├── context_enhancement.py # 多框架上下文
│   └── updates.py             # 缓存管理和更新
├── providers/                  # 文档源提供商
│   ├── github.py              # GitHub API 集成
│   ├── website.py             # 网页抓取提供商
│   └── base.py                # 提供商接口
├── utils/                      # 共享实用工具
│   ├── github_client.py       # 带有速率限制的 GitHub API 客户端
│   └── validation.py          # 数据验证实用工具
└── server.py                  # FastMCP 服务器实现

frameworks/                     # 按类别划分的框架配置
├── web/                       # Web 框架
│   ├── tailwindcss.json
│   ├── react.json
│   └── nextjs.json
├── backend/                   # 后端框架
│   └── fastapi.json
├── design/                    # 设计系统
│   └── shadcn-ui.json
└── ai-ml/                     # AI/ML 框架
    ├── mcp-sdk-python.json
    └── anthropic-sdk.json

框架配置模式

{
  "name": "framework-name",
  "display_name": "框架显示名称",
  "category": "web|backend|mobile|ai-ml|design|tools",
  "type": "framework|library|tool|service", 
  "version": "latest",
  "sources": {
    "documentation": {
      "github": {
        "repo": "owner/repository",
        "docs_path": "docs",
        "branch": "main"
      },
      "website": "https://docs.framework.com"
    },
    "examples": {
      "github": {
        "repo": "owner/examples",
        "docs_path": "examples", 
        "branch": "main"
      }
    }
  },
  "context_files": ["README.md", "CHANGELOG.md", "API.md"],
  "key_features": ["feature1", "feature2", "feature3"],
  "common_patterns": ["pattern1", "pattern2"],
  "priority": 50
}

🛠️ 安装

前提条件

Python 3.11+
uv（推荐）或 pip

安装步骤

# 克隆仓库
git clone <repository-url>
cd augments-mcp-server

# 使用 uv 安装（推荐）
uv sync

# 或者使用 pip 安装
pip install -e .

环境配置

创建一个 .env 文件进行可选配置：

# 缓存设置
AUGMENTS_CACHE_DIR=~/.cache/augments-mcp-server
AUGMENTS_CACHE_TTL=3600

# GitHub API（可选，用于更高的速率限制）
GITHUB_TOKEN=your_github_token_here

# 日志记录
LOG_LEVEL=INFO

🚀 使用

选项 1：托管 MCP 服务器（推荐）

为了最简单的设置，请直接连接到我们的托管 MCP 服务器 https://mcp.augments.dev/mcp。无需安装！

使用 Claude Code CLI

# 添加托管 MCP 服务器
claude mcp add --transport http augments https://mcp.augments.dev/mcp

# 验证服务器是否已配置
claude mcp list

# 获取服务器详情
claude mcp get augments

使用 Cursor

添加到你的 Cursor MCP 配置：

{
  "mcpServers": {
    "augments": {
      "transport": "http",
      "url": "https://mcp.augments.dev/mcp"
    }
  }
}

手动配置（Claude Desktop）

添加到你的 Claude Desktop MCP 配置文件：

位置：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "augments": {
      "transport": {
        "type": "streamable-http",
        "url": "https://mcp.augments.dev/mcp"
      }
    }
  }
}

使用托管服务器

一旦配置完成，你可以直接访问所有框架文档：

访问框架文档：

@augments 列出 web 类别的框架
@augments 获取 tailwindcss 响应式设计文档

获取多框架上下文：

@augments 获取 nextjs、tailwindcss 和 shadcn-ui 的上下文
用于构建具有暗模式的仪表板

分析代码兼容性：

@augments 分析此 React 组件的 tailwindcss 兼容性：
[粘贴你的代码]

搜索文档：

@augments 在 nextjs 文档中搜索“应用路由器”

托管服务器提供：

✅ 无需安装 - 即刻可用
✅ 始终最新 - 最新的框架文档
✅ 高可用性 - 智能缓存确保可靠运行时间
✅ 无认证 - 完全无障碍访问
✅ 速率限制保护 - 智能滥用预防
✅ 符合 MCP 协议 - 使用官方 MCP Python SDK 和 streamable-http 运输
✅ 多客户端支持 - 与 Claude Code、Cursor 和其他 MCP 客户端兼容

选项 2：本地安装

为了开发、自定义或离线使用，你可以本地运行服务器。

启动本地服务器

# 使用 uv 运行（推荐）
uv run augments-mcp-server

# 或直接运行
python -m augments_mcp.server

# 开发模式带自动重载
uv run fastmcp dev src/augments_mcp/server.py

Claude Code 集成（本地）

方法 1：使用 Claude Code CLI（推荐）

# 使用环境变量添加本地 MCP 服务器
claude mcp add augments-local -e AUGMENTS_CACHE_DIR="~/.cache/augments-mcp-server" -e GITHUB_TOKEN="your_github_token" -- uv run augments-mcp-server

# 验证服务器是否已配置
claude mcp list

# 获取服务器详情
claude mcp get augments-local

方法 2：手动配置

{
  "mcpServers": {
    "augments-local": {
      "command": "uv",
      "args": ["run", "augments-mcp-server"],
      "cwd": "/path/to/augments-mcp-server",
      "env": {
        "AUGMENTS_CACHE_DIR": "~/.cache/augments-mcp-server",
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

方法 3：全局配置

# 使用完整路径到项目目录添加
claude mcp add augments-local -e GITHUB_TOKEN="your_github_token" -- uv run --directory /path/to/augments-mcp-server augments-mcp-server

服务器管理

# 列出所有已配置的 MCP 服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get augments

# 如需移除服务器
claude mcp remove augments

# 更新服务器配置（移除并重新添加）
claude mcp remove augments
claude mcp add --transport http augments https://mcp.augments.dev/mcp

故障排除

服务器未出现：配置后重启 Claude Code
连接错误：对于托管服务器，检查互联网连接；对于本地服务器，验证安装
环境问题：仅适用于本地安装
权限错误：确保 Claude Code 具有网络访问权限（托管）或文件访问权限（本地）

🔧 MCP 工具

框架发现

`list_available_frameworks`

列出所有可用框架，可选按类别过滤。

{
  "category": "web"
}

`search_frameworks`

按名称、功能或关键词搜索框架。

{
  "query": "react 组件库"
}

`get_framework_info`

获取特定框架的详细信息。

{
  "framework": "tailwindcss"
}

文档访问

`get_framework_docs`

检索框架的综合文档。

{
  "framework": "nextjs",
  "section": "app-router",
  "use_cache": true
}

`get_framework_examples`

获取特定模式下的框架代码示例。

{
  "framework": "react",
  "pattern": "hooks"
}

`search_documentation`

在框架的缓存文档中搜索。

{
  "framework": "tailwindcss",
  "query": "响应式设计",
  "limit": 10
}

上下文增强

`get_framework_context`

根据开发任务获取多个框架的相关上下文。

{
  "frameworks": ["nextjs", "tailwindcss", "shadcn-ui"],
  "task_description": "构建具有暗模式的响应式仪表板"
}

`analyze_code_compatibility`

分析代码的框架兼容性并提出改进建议。

{
  "code": "const App = () => { return <div className='p-4'>Hello</div> }",
  "frameworks": ["react", "tailwindcss"]
}

缓存管理

`check_framework_updates`

检查框架文档自上次缓存以来是否已更新。

{
  "framework": "nextjs"
}

`refresh_framework_cache`

刷新框架的缓存文档。

{
  "framework": "react",
  "force": false
}

`get_cache_stats`

获取详细的缓存统计信息和性能指标。

{}

📚 支持的框架

涵盖 8 个类别的 85+ 框架，为现代开发堆栈提供全面的文档覆盖：

Web 框架（25）

React - 用于构建用户界面的 JavaScript 库
Next.js - 用于生产应用程序的 React 框架
Vue.js - 进步的 JavaScript 框架
Angular - 构建 Web 应用程序的平台
Svelte - 编译时优化的 Web 框架
SvelteKit - 全栈 Svelte 框架
Astro - 基于岛屿架构的静态站点生成器
Remix - 专注于 Web 基础的全栈 Web 框架
Qwik - 可恢复的 Web 框架
SolidJS - 反应式 JavaScript 库
Preact - 快速的 3kB React 替代品
Alpine.js - 用于 HTML 增强的最小框架
Lit - 用于构建 Web 组件的简单库
Stimulus - 用于 HTML 的 JavaScript 框架
HTMX - 带有最少 JavaScript 的现代 HTML
Tailwind CSS - 以实用为主的 CSS 框架
Bootstrap - 用于响应式设计的 CSS 框架
Bulma - 基于 Flexbox 的现代 CSS 框架
Foundation - 响应式前端框架
Material-UI - 实现 Google 的 Material Design 的 React 组件
Chakra UI - 简单、模块化且可访问的 React 组件
Mantine - 功能齐全的 React 组件库
Semantic UI - 创建美观、响应式布局的开发框架
Three.js - JavaScript 3D 库
D3.js - 数据驱动文档库

后端框架（18）

FastAPI - 现代、快速的 Python Web 框架
Django - 高级的 Python Web 框架
Flask - 轻量级的 Python Web 框架
Pyramid - Python Web 框架
Sanic - 异步的 Python Web 服务器/框架
Express.js - 快速、不偏不倚的 Node.js Web 框架
Fastify - 快速且低开销的 Node.js Web 框架
Koa.js - 表达力强的 Node.js 中间件
NestJS - 进步的 Node.js 框架
Laravel - PHP Web 应用程序框架
Ruby on Rails - 服务器端 Web 应用程序框架
Spring Boot - 基于 Java 的框架
Actix - Rust Web 框架
Axum - 人体工程学和模块化的 Rust Web 框架
Phoenix - Elixir Web 框架
Echo - 高性能的 Go Web 框架
Gin - Go 的 HTTP Web 框架
Fiber - 向 Express 致敬的 Go Web 框架

AI/ML 框架（14）

PyTorch - 机器学习框架
TensorFlow - 端到端 ML 平台
Scikit-learn - Python 的机器学习库
NumPy - 科学计算的基本包
Pandas - 数据操作和分析库
Matplotlib - Python 的绘图库
Seaborn - 统计数据可视化
OpenCV - 计算机视觉库
Hugging Face - Transformers 和数据集库
LangChain - 开发 LLM 应用程序的框架
Streamlit - 用于 ML 和数据科学的应用框架
Gradio - 构建 ML Web 应用
MCP SDK Python - 模型上下文协议 Python SDK
Anthropic SDK - Anthropic API 的 Python SDK

移动框架（6）

React Native - 使用 React 构建移动应用
Flutter - Google 的移动 UI 工具包
Expo - 通用 React 应用程序的平台
Ionic - 跨平台移动应用开发
Capacitor - 跨平台原生运行时
Xamarin - Microsoft 的移动开发平台

数据库 & ORM（5）

Prisma - 下一代 Node.js 和 TypeScript ORM
Mongoose - Node.js 的 MongoDB 对象建模
TypeORM - TypeScript 和 JavaScript 的 ORM
SQLAlchemy - Python 的 SQL 工具包和 ORM
Sequelize - 基于 Promise 的 Node.js ORM

状态管理（4）

Redux - JavaScript 的可预测状态容器
Zustand - 小型、快速且可扩展的状态管理
MobX - 反应式状态管理
Recoil - React 的实验性状态