🚀 Augments MCP Server
Augments MCP Serverは、Model Context Protocol (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": "Framework 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 sync
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サーバー (推奨)
最も簡単なセットアップ方法は、https://mcp.augments.dev/mcpのホステッドMCPサーバーに直接接続することです。インストールは不要です!
Claude Code CLIを使用する
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 list frameworks in the web category
@augments get documentation for tailwindcss responsive design
-
複数フレームワークコンテキストを取得する:
@augments get context for nextjs, tailwindcss, and shadcn-ui
for building a dashboard with dark mode
-
コード互換性を分析する:
@augments analyze this React component for tailwindcss compatibility:
[paste your code]
-
ドキュメントを検索する:
@augments search nextjs documentation for "app router"
ホステッドサーバーは以下の利点を提供します:
- ✅ インストール不要 - すぐに使用可能
- ✅ 常に最新 - 最新のフレームワークドキュメント
- ✅ 高可用性 - スマートキャッシュによる信頼性の高い稼働時間
- ✅ 認証不要 - 完全に摩擦のないアクセス
- ✅ レート制限保護 - インテリジェントな不正利用防止
- ✅ MCPプロトコル準拠 - ストリーマブルHTTPトランスポートを使用した公式MCP Python SDK
- ✅ 複数クライアントサポート - Claude Code、Cursor、および他のMCPクライアントと互換性があります。
オプション2: ローカルインストール
開発、カスタマイズ、またはオフライン使用のために、サーバーをローカルで実行することができます。
ローカルサーバーを起動する
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を使用する (推奨)
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
サーバー管理
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 component library"
}
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": "responsive design",
"limit": 10
}
コンテキスト強化
get_framework_context
開発タスクに基づいて複数のフレームワークの関連コンテキストを取得します。
{
"frameworks": ["nextjs", "tailwindcss", "shadcn-ui"],
"task_description": "Building a responsive dashboard with dark mode"
}
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のマテリアルデザインを実装した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 - トランスフォーマーとデータセットライブラリ
- LangChain - LLMアプリケーションを開発するためのフレームワーク
- Streamlit - MLとデータサイエンス用のアプリフレームワーク
- Gradio - ML Webアプリを構築する
- MCP SDK Python - Model Context Protocol 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 - MongoDBのNode.js用オブジェクトモデリング
- TypeORM - TypeScriptとJavaScript用のORM
- SQLAlchemy - PythonのSQLツールキットとORM
- Sequelize - プロミスベースのNode.js ORM
ステート管理 (4)
- Redux - JavaScript用の予測可能なステートコンテナ
- Zustand - 小さくて高速でスケーラブルなステート管理
- MobX - リアクティブなステート管理
- Recoil - React用の実験的なステート管理
テストフレームワーク (5)
- Jest - JavaScriptテストフレームワーク
- Vitest - 高速なViteネイティブのユニットテストフレームワーク
- Cypress - エンドツーエンドのテストフレームワーク
- Playwright - Webテストと自動化
- pytest - Pythonテストフレームワーク
開発ツール (7)
- Webpack - モジュールバンドラー
- Vite - 高速なビルドツール
- Parcel - ゼロ構成のビルドツール
- Rollup - JavaScript用のモジュールバンドラー
- ESLint - JavaScriptリンター
- Prettier - コードフォーマッター
- Turbo - 高性能のビルドシステム
- Nx - スマートで高速で拡張可能なビルドシステム
DevOpsとインフラストラクチャ (4)
- Docker - コンテナ化プラットフォーム
- Kubernetes - コンテナオーケストレーション
- Terraform - インフラストラクチャをコードとして扱う
- Ansible - 自動化プラットフォーム
デザインシステム (1)
- shadcn/ui - 美しくデザインされたReactコンポーネント
🔄 新しいフレームワークの追加
1. フレームワーク構成を作成する
適切なカテゴリディレクトリにJSONファイルを作成します。
frameworks/web/my-framework.json
frameworks/backend/my-framework.json
2. フレームワーク構成の例
{
"name": "my-framework",
"display_name": "My Awesome Framework",
"category": "web",
"type": "framework",
"version": "2.0.0",
"sources": {
"documentation": {
"github": {
"repo": "myorg/my-framework",
"docs_path": "docs",
"branch": "main"
},
"website": "https://myframework.dev/docs"
},
"examples": {
"github": {
"repo": "myorg/my-framework-examples",
"docs_path": "examples",
"branch": "main"
}
}
},
"context_files": ["README.md", "GUIDE.md"],
"key_features": ["fast", "modern", "typescript"],
"common_patterns": ["component-based", "declarative"],
"priority": 60
}
3. 構成フィールド
| フィールド |
タイプ |
必須 |
説明 |
name |
文字列 |
✅ |
一意のフレームワーク識別子 |
display_name |
文字列 |
✅ |
人間が読みやすい名前 |
category |
文字列 |
✅ |
フレームワークのカテゴリ |
type |
文字列 |
✅ |
フレームワークのタイプ |
version |
文字列 |
❌ |
バージョン (デフォルト: "latest") |
sources |
オブジェクト |
✅ |
ドキュメントソース |
context_files |
配列 |
✅ |
含める重要なファイル |
key_features |
配列 |
✅ |
主な機能/能力 |
common_patterns |
配列 |
✅ |
使用パターン |
priority |
数値 |
❌ |
重要度 (1-100、デフォルト: 50) |
サーバーは新しいフレームワーク構成を自動的に検出し、再起動することなくホットリロードします。
🧪 開発
テストの実行
uv run pytest
uv run pytest tests/test_models.py -v
uv run pytest tests/test_cache.py -v
uv run pytest tests/test_tools.py -v
uv run pytest --cov=src/augments_mcp --cov-report=html
コード品質
uv run black src tests
uv run ruff check src tests
uv run mypy src
uv run black src tests && uv run ruff check src tests && uv run mypy src
開発サーバー
uv run fastmcp dev src/augments_mcp/server.py
LOG_LEVEL=DEBUG uv run augments-mcp-server
🏛️ 技術詳細
コアテクノロジー
- FastMCP: 公式MCP Python SDK with streamable-http transport
- Pydantic: データ検証とシリアライゼーション
- httpx: APIリクエスト用の非同期HTTPクライアント
- BeautifulSoup4: ウェブスクレイピング用のHTMLパーサー
- diskcache: TTLサポート付きの永続的なキャッシュ
- structlog: 観測可能性のための構造化ロギング
- watchdog: ホットリロード用のファイルシステム監視
MCPプロトコルの実装
- トランスポート: Streamable-HTTP (公式MCP仕様)
- エンドポイント:
/mcp (FastMCPによって自動的にマウントされます)
- プロトコルバージョン: MCP 2024-11-05仕様
- クライアント互換性: Claude Code、Cursor、およびすべてのMCP準拠クライアント
- メッセージ形式: ストリーミングサポート付きのHTTP上のJSON-RPC
- セキュリティ: ホステッドデプロイメントのためのHTTPS/TLS暗号化
設計原則
- 非同期優先: すべてのI/O操作はasync/awaitを使用
- 型安全性: 全体を通じて包括的な型ヒント
- エラー耐性: 詳細なエラーを伴うグレースフルデグラデーション
- パフォーマンス: 多段階キャッシュと効率的なデータ構造
- 拡張性: 新しいプロバイダーのためのプラグインベースのアーキテクチャ
- 観測可能性: 構造化ロギングと包括的なメトリクス
キャッシュ戦略
- メモリキャッシュ: 最近使用されたデータの高速アクセス
- ディスクキャッシュ: TTL有効期限付きの永続的なストレージ
- TTL戦略: コンテンツの安定性に基づく異なる期間
- 安定版リリース: 24時間
- ベータ版: 6時間
- 開発ブランチ: 1時間
- スマートな無効化: ソースの更新に基づく自動リフレッシュ
🤝 コントリビューション
コントリビューションを歓迎します!以下の手順に従ってください。
- リポジトリをフォークする
- 機能ブランチを作成する:
git checkout -b feature/amazing-feature
- 新機能に対して包括的なテストを追加する
- コード品質を確保する: フォーマッターとリンターを実行する
- 新機能に対してドキュメントを更新する
- 詳細な説明付きでプルリクエストを送信する
開発セットアップ
git clone https://github.com/yourusername/augments-mcp-server.git
cd augments-mcp-server
uv sync
uv run pytest
📄 ライセンス
このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。
🆘 サポート
Claude Codeエコシステムのために愛情を込めて作成されました