FastAPI MCP Server

# MCP Server एक production-ready Model Context Protocol (MCP) server जो FastAPI framework का उपयोग करके बनाई गई है। ## विशेषताएं (Features) - 🚀 **FastAPI Framework**: High-performance async API server - 🔒 **Security**: JWT authentication और secure coding practices - 🗄️ **Database**: PostgreSQL के साथ asyncpg - 📦 **Caching**: Redis integration - 🐳 **Docker Ready**: Production-ready containerization - 📊 **Health Checks**: Built-in health monitoring - 🔧 **Development Ready**: Comprehensive testing और development tools ## आवश्यकताएं (Requirements) - Python 3.11+ - PostgreSQL 13+ - Redis 6+ - Docker (optional) ## इंस्टॉलेशन (Installation) ### 1. Repository Clone करें ```bash git clone <repository-url> cd mcp-server ``` ### 2. Virtual Environment बनाएं ```bash python -m venv venv source venv/bin/activate # Linux/Mac # या venv\\Scripts\\activate # Windows ``` ### 3. Dependencies Install करें ```bash pip install -r requirements.txt ``` ### 4. Environment Variables सेट करें `.env` file बनाएं: ```env # Database DATABASE_URL=postgresql://username:password@localhost:5432/mcp_db # Redis REDIS_URL=redis://localhost:6379/0 # Security SECRET_KEY=your-secret-key-here JWT_ALGORITHM=HS256 JWT_EXPIRE_MINUTES=30 # Server HOST=0.0.0.0 PORT=8000 DEBUG=false ``` ## Usage ### Development Mode ```bash uvicorn main:app --reload --host 0.0.0.0 --port 8000 ``` ### Production Mode ```bash uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4 ``` ### Docker के साथ ```bash # Build करें docker build -t mcp-server . # Run करें docker run -p 8000:8000 --env-file .env mcp-server ``` ## API Documentation ### Base URL ``` http://localhost:8000 ``` ### Interactive Documentation - **Swagger UI**: http://localhost:8000/docs - **ReDoc**: http://localhost:8000/redoc ### Main Endpoints #### Health Check ```http GET /health ``` Server की health status check करता है। #### API Endpoints ```http GET /api/v1/status POST /api/v1/connect GET /api/v1/tools POST /api/v1/tools/{tool_name}/call ``` ## Development ### Code Quality ```bash # Format code black . # Sort imports isort . # Lint code flake8 . # Type checking mypy . ``` ### Testing ```bash # सभी tests run करें pytest # Coverage के साथ pytest --cov=src tests/ # Specific test file pytest tests/test_main.py ``` ## Project Structure ``` mcp-server/ ├── src/ # Source code │ ├── main.py # FastAPI application │ ├── models/ # Pydantic models │ ├── routes/ # API routes │ ├── services/ # Business logic │ ├── database/ # Database configuration │ └── utils/ # Utility functions ├── tests/ # Test files ├── requirements.txt # Python dependencies ├── Dockerfile # Docker configuration ├── docker-compose.yml # Docker Compose (optional) ├── .env.example # Environment variables template ├── .gitignore # Git ignore patterns ├── .dockerignore # Docker ignore patterns └── README.md # This file ``` ## Configuration ### Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `DATABASE_URL` | PostgreSQL connection URL | Required | | `REDIS_URL` | Redis connection URL | redis://localhost:6379/0 | | `SECRET_KEY` | JWT secret key | Required | | `JWT_ALGORITHM` | JWT algorithm | HS256 | | `JWT_EXPIRE_MINUTES` | JWT expiration time | 30 | | `HOST` | Server host | 0.0.0.0 | | `PORT` | Server port | 8000 | | `DEBUG` | Debug mode | false | ### Database Setup ```sql -- PostgreSQL database बनाएं CREATE DATABASE mcp_db; -- User बनाएं (optional) CREATE USER mcp_user WITH PASSWORD 'secure_password'; GRANT ALL PRIVILEGES ON DATABASE mcp_db TO mcp_user; ``` ### Redis Setup ```bash # Redis start करें redis-server # या Docker के साथ docker run -d -p 6379:6379 redis:alpine ``` ## Security Features - JWT-based authentication - Password hashing with bcrypt - CORS protection - Rate limiting - Input validation - SQL injection protection - XSS protection ## Monitoring ### Health Checks ```bash # Server health check curl http://localhost:8000/health # Database connection check curl http://localhost:8000/health/db # Redis connection check curl http://localhost:8000/health/redis ``` ### Logging Logs `/logs/` directory में store होते हैं। Production में proper logging configuration set करें। ## Deployment ### Docker Deployment ```bash # Production image build करें docker build -t mcp-server:latest . # Docker Compose के साथ docker-compose up -d ``` ### Manual Deployment ```bash # Gunicorn के साथ gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker ``` ## Contributing 1. Fork करें 2. Feature branch बनाएं (`git checkout -b feature/amazing-feature`) 3. Commit करें (`git commit -m 'Add amazing feature'`) 4. Push करें (`git push origin feature/amazing-feature`) 5. Pull Request open करें ## License यह project MIT license के under है। ## Support समस्याओं के लिए GitHub Issues create करें या documentation पढ़ें। ## Changelog ### v1.0.0 - Initial release - FastAPI integration - JWT authentication - Redis caching - Docker support - Comprehensive documentation