Changelog

🔧 Fixes:

• Fixed RuntimeError: can't start new thread in Railway deployments
• Resolved infinite shutdown loops causing repeated server restarts
• Fixed threading exhaustion under heavy load conditions
• Eliminated resource leaks in HTTP connection pools

🚀 Improvements:

• Added proper signal handling to prevent shutdown cascades
• Implemented background task tracking and cancellation
• Added conservative HTTP connection limits to prevent thread exhaustion
• Enhanced graceful shutdown with comprehensive error handling
• Added environment variable configuration for HOST/PORT

📦 Technical Details:

• Implemented signal deduplication to prevent multiple shutdown attempts
• Added proper async task lifecycle management
• Reduced HTTP connection pool limits for better resource management
• Enhanced provider cleanup with exception handling
• Added shutdown state tracking to prevent race conditions

This release ensures stable, long-running operation in production environments without threading issues.

Installation

PyPI

pip install augments-mcp-server==2.0.5

uv

uv add augments-mcp-server==2.0.5

MCP Server Registry

The server is available in the MCP server registry at dev.augments/mcp.

🔧 Fixes:

• Fixed RuntimeWarning about module imports when using python -m execution
• Resolved websockets deprecation warnings by switching to wsproto
• Fixed FastMCP TypeError when configuring WebSocket implementation

🚀 Improvements:

• Clean startup logs without deprecation warnings
• Proper uvicorn WebSocket configuration
• Maintained backward compatibility with all existing functionality

📦 Technical Details:

• Added wsproto dependency for modern WebSocket implementation
• Implemented monkey patch for uvicorn configuration
• Created clean main entry point to avoid import warnings
• Updated deployment configurations for Railway

This release ensures clean, warning-free operation in production environments.

Installation

PyPI

pip install augments-mcp-server==2.0.4

uv

uv add augments-mcp-server==2.0.4

MCP Server Registry

The server is available in the MCP server registry at dev.augments/mcp.

🚀 Augments MCP Server v2.0.3

A maintenance release that fixes documentation paths for all 92 supported frameworks to ensure accurate and accessible documentation.

🔧 Framework Documentation Fixes

• Fixed 53 framework documentation paths - Updated all incorrect GitHub repository and documentation paths
• Verified all 92 frameworks - Ensured every framework points to valid, accessible documentation
• Corrected repository references - Many frameworks now point to dedicated documentation repositories
• Improved documentation quality - All paths now lead to actual markdown documentation files, not source code

📚 Notable Framework Updates

• TailwindCSS: Now points to tailwindlabs/tailwindcss.com/src/pages/docs
• React: Updated to reactjs/react.dev/src/content/reference
• Streamlit: Corrected to dedicated streamlit/docs/content repository
• Angular: Fixed to aio/content/guide for proper documentation
• Spring Boot: Updated to correct documentation path in main repository
• Xamarin: Migrated to modern .NET MAUI documentation at dotnet/docs-maui

🎯 What's Fixed

• No more 404 errors - All framework documentation paths are now verified and working
• Accurate documentation sources - Frameworks now reference official documentation locations
• Better framework coverage - Improved access to comprehensive documentation for all supported frameworks
• Consistent quality - All frameworks follow the same high standard for documentation accessibility

🌐 Hosted Service

The hosted MCP server remains the easiest way to get started:

# Add the hosted MCP server
claude mcp add --transport http augments https://mcp.augments.dev/mcp

💡 Impact

This release significantly improves the reliability and accuracy of framework documentation retrieval, ensuring developers have access to the most current and comprehensive documentation for all 92 supported frameworks.

Built with ❤️ for the Claude Code ecosystem

🚀 Augments MCP Server v2.0.2

A patch release with updated MCP server naming convention for better discoverability.

📝 Updates

• Updated MCP Server Name - Changed from io.github.augmnt/augments-mcp-server to dev.augments/mcp
• Consistent Naming - Updated server.json and README.md to use the new naming convention
• Version Synchronization - Bumped version to 2.0.2 across all configuration files

🌐 Hosted Service

The hosted MCP server continues to be the easiest way to get started:

# Add the hosted MCP server
claude mcp add --transport http augments https://mcp.augments.dev/mcp

💡 Migration Notes

• Server name changed from io.github.augmnt/augments-mcp-server to dev.augments/mcp
• No functional changes - All existing functionality remains the same
• No action required for users of the hosted service
• Local installations continue to work as before

🔧 Technical Details

• Updated server.json name field for MCP registry compatibility
• Synchronized version numbers across pyproject.toml and server.json
• Updated documentation references to use new naming convention

Built with ❤️ for the Claude Code ecosystem

🚀 Augments MCP Server v2.0.1

A patch release with important MCP protocol fixes and streamable-http transport improvements.

🔧 Key Fixes

• Fixed MCP Protocol Implementation - Proper compliance with official MCP Python SDK
• Streamable HTTP Transport - Correctly mounted at /mcp endpoint for web deployment
• Railway Deployment - Removed invalid health check configuration causing 404 errors
• Updated Documentation - Corrected installation instructions for Claude Code and Cursor

🌐 Hosted Service

The hosted MCP server continues to be the easiest way to get started:

# Add the hosted MCP server (corrected command)
claude mcp add --transport http augments https://mcp.augments.dev/mcp

🐛 Bug Fixes

• Fixed FastMCP configuration to use proper streamable-http transport
• Removed unsupported health check endpoint that was causing AttributeError
• Updated Railway configuration to remove health check requirements
• Corrected MCP server URL in all documentation from http://mcp.augments.dev to https://mcp.augments.dev/mcp

📚 Updated Documentation

• Fixed Claude Code installation commands with proper transport specification
• Updated Cursor MCP configuration examples
• Synchronized version numbers between pyproject.toml and server.json

💡 Technical Improvements

• Proper FastMCP server initialization with web deployment configuration
• Streamable HTTP transport automatically mounted at /mcp as per MCP specification
• Enhanced error handling and Railway deployment compatibility

Built with ❤️ for the Claude Code ecosystem

🚀 Augments MCP Server v2.0.0

A comprehensive framework documentation provider for Claude Code via Model Context Protocol (MCP). Now available as both a hosted service and local installation!

✨ Key Features

• 92 frameworks across 9 categories (Web, Backend, AI/ML, Mobile, Database, State Management, Testing, DevOps, Design)
• Hosted MCP Server at mcp.augments.dev - No installation required!
• Production-ready web API with intelligent rate limiting and abuse protection
• Smart caching system with Redis support and edge caching
• Multi-framework context generation for development tasks
• Code compatibility analysis with detailed suggestions
• Real-time documentation retrieval from GitHub and official sites
• 12 comprehensive MCP tools for complete development workflow

🌐 Hosted Service (NEW!)

The easiest way to get started - no installation required:

# Add the hosted MCP server
claude mcp add augments http://mcp.augments.dev

Benefits:

• ✅ No installation required - Works immediately
• ✅ Always up-to-date - Latest framework documentation
• ✅ High availability - Reliable uptime with smart caching
• ✅ No authentication - Completely frictionless access
• ✅ Rate limiting protection - Intelligent abuse prevention

🏗️ Framework Coverage

• Web: 25 frameworks (React, Next.js, Vue, Angular, Tailwind CSS, etc.)
• Backend: 18 frameworks (FastAPI, Django, Express, NestJS, etc.)
• AI/ML: 14 frameworks (PyTorch, TensorFlow, Hugging Face, MCP SDK, etc.)
• Mobile: 6 frameworks (React Native, Flutter, Expo, etc.)
• Development Tools: 7 frameworks (Webpack, Vite, ESLint, Prettier, etc.)
• Database & ORM: 5 frameworks (Prisma, TypeORM, SQLAlchemy, etc.)
• State Management: 4 frameworks (Redux, Zustand, MobX, Recoil)
• Testing: 5 frameworks (Jest, Vitest, Cypress, Playwright, pytest)
• DevOps: 4 frameworks (Docker, Kubernetes, Terraform, Ansible)
• Design: 1 component library (shadcn/ui)

🔧 Installation (Local)

git clone https://github.com/augmnt/augments-mcp-server.git
cd augments-mcp-server
uv sync

📚 Claude Code Integration

Option 1 - Hosted (Recommended):

claude mcp add augments http://mcp.augments.dev

Option 2 - Local:

claude mcp add augments-local -- uv run augments-mcp-server

🆕 What's New in v2.0.0

🌐 Hosted Service

• Production web server deployed at mcp.augments.dev
• FastAPI-based architecture with comprehensive middleware stack
• Smart rate limiting with behavioral analysis and progressive limits
• Edge caching with TTL strategies for optimal performance
• Abuse detection with pattern recognition and bot filtering
• CloudFlare integration for DDoS protection and bot detection
• Request coalescing to prevent duplicate operations
• Redis caching for distributed performance

📚 Enhanced Framework Support

• 13 new frameworks added across multiple categories
• New categories: State Management, Testing, DevOps
• Enhanced documentation sources with better coverage
• Improved framework prioritization and organization

🔧 Developer Experience

• Docker containerization with optimized Railway deployment
• Comprehensive deployment guides (Railway, Docker, local)
• Environment configuration templates and examples
• Enhanced monitoring with structured logging and metrics
• Hot-reloading configuration for dynamic framework updates

🛠️ Architecture Improvements

• Dual-mode operation: Both MCP server and web API
• Advanced middleware stack for production scalability
• Improved error handling with graceful degradation
• Enhanced security with multiple protection layers
• Performance optimizations throughout the stack

🐛 Bug Fixes

• Fixed framework category validation for new categories
• Improved Redis connection handling and failover
• Enhanced Docker build process with proper dependency management
• Fixed middleware initialization order and ASGI compatibility
• Resolved health check issues with trusted host middleware

💡 Migration Notes

• Hosted service is recommended for most users - no migration needed
• Local installations continue to work as before
• New environment variables available for advanced configuration
• Framework configurations are backward compatible

Built with ❤️ for the Claude Code ecosystem

🚀 Augments MCP Server v1.0.0

A comprehensive framework documentation provider for Claude Code via Model Context Protocol (MCP).

✨ Key Features

• 79 frameworks across 7 categories (Web, Backend, AI/ML, Mobile, Database, Tools, Design)
• Intelligent caching system with TTL-based strategies
• Multi-framework context generation for development tasks
• Code compatibility analysis with detailed suggestions
• Real-time documentation retrieval from GitHub and official sites
• 9 comprehensive MCP tools for complete development workflow

🏗️ Framework Coverage

• Web: 28 frameworks (React, Next.js, Vue, Angular, Tailwind CSS, etc.)
• Backend: 18 frameworks (FastAPI, Django, Express, NestJS, etc.)
• AI/ML: 14 frameworks (PyTorch, TensorFlow, Hugging Face, etc.)
• Mobile: 6 frameworks (React Native, Flutter, Expo, etc.)
• Tools: 7 frameworks (Webpack, Vite, ESLint, Prettier, etc.)
• Database: 5 ORMs (Prisma, TypeORM, SQLAlchemy, etc.)
• Design: 1 component library (shadcn/ui)

🔧 Installation

git clone https://github.com/augmnt/augments-mcp-server.git
cd augments-mcp-server
uv sync

📚 Claude Code Integration

claude mcp add augments -- uv run augments-mcp-server

🆕 What's New in v1.0.0

- Initial stable release
- Complete framework registry with 79+ frameworks
- Advanced caching and context enhancement
- Manual release process (removed automated workflows)