viyv-mcp

# viyv_mcp **viyv_mcp** is a production-ready Python wrapper around [FastMCP](https://github.com/jlowin/fastmcp) and [Starlette](https://www.starlette.io/) that simplifies creating MCP (Model Context Protocol) servers with minimal boilerplate. [](https://badge.fury.io/py/viyv_mcp) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://pypi.org/project/viyv_mcp/) ## 🚀 Quick Start ```bash # Install the package pip install viyv_mcp # Create a new MCP server project create-viyv-mcp new my_mcp_server # Navigate to the project and install dependencies cd my_mcp_server uv sync # Run the server uv run python main.py ``` Your MCP server is now running at `http://localhost:8000` 🎉 ## ✨ Key Features ### 🛠️ Simple Tool Creation ```python from viyv_mcp import tool @tool(description="Add two numbers") def add(a: int, b: int) -> int: return a + b ``` ### 🌉 External MCP Server Bridge ```json // app/mcp_server_configs/filesystem.json { "command": "npx", "args": ["@modelcontextprotocol/server-filesystem", "/workspace"], "env": { "API_KEY": "$API_KEY" // Environment variable interpolation }, "cwd": "/path/to/working/dir", // Optional "tags": ["filesystem", "io"] // Optional: for filtering } ``` ### 🚀 Production-Ready Multi-Worker Support (New in v0.1.10) ```bash # Enable stateless HTTP mode for multi-worker deployments STATELESS_HTTP=true uv run python main.py # Deploy with Gunicorn (recommended for production) uv pip install gunicorn STATELESS_HTTP=true uv run gunicorn main:app \ -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 ``` ### 🔒 JWT Authentication & Access Control ```python # Tools with security metadata @tool( description="Query salar…