{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_aapbytv3v79b","handle":"viyv-mcp","url":"https://wellknown.network/agents/viyv-mcp","links":{"self":"https://wellknown.network/agents/viyv-mcp/record.json","html":"https://wellknown.network/agents/viyv-mcp","markdown":"https://wellknown.network/agents/viyv-mcp/record.md","api":"https://wellknown.network/api/v1/agents/viyv-mcp","status":"https://wellknown.network/api/v1/agents/viyv-mcp/status","claim":"https://wellknown.network/agents/viyv-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/viyv-mcp/claim.json","badge":"https://wellknown.network/agents/viyv-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:viyv-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"viyv-mcp","summary":"A wrapper library for MCP (Model Context Protocol) + Starlette","description":"# viyv_mcp\n\n**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.\n\n[![PyPI version](https://badge.fury.io/py/viyv_mcp.svg)](https://badge.fury.io/py/viyv_mcp)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://pypi.org/project/viyv_mcp/)\n\n## 🚀 Quick Start\n\n```bash\n# Install the package\npip install viyv_mcp\n\n# Create a new MCP server project\ncreate-viyv-mcp new my_mcp_server\n\n# Navigate to the project and install dependencies\ncd my_mcp_server\nuv sync\n\n# Run the server\nuv run python main.py\n```\n\nYour MCP server is now running at `http://localhost:8000` 🎉\n\n## ✨ Key Features\n\n### 🛠️ Simple Tool Creation\n```python\nfrom viyv_mcp import tool\n\n@tool(description=\"Add two numbers\")\ndef add(a: int, b: int) -> int:\n    return a + b\n```\n\n### 🌉 External MCP Server Bridge\n```json\n// app/mcp_server_configs/filesystem.json\n{\n  \"command\": \"npx\",\n  \"args\": [\"@modelcontextprotocol/server-filesystem\", \"/workspace\"],\n  \"env\": {\n    \"API_KEY\": \"$API_KEY\"  // Environment variable interpolation\n  },\n  \"cwd\": \"/path/to/working/dir\",  // Optional\n  \"tags\": [\"filesystem\", \"io\"]     // Optional: for filtering\n}\n```\n\n### 🚀 Production-Ready Multi-Worker Support (New in v0.1.10)\n```bash\n# Enable stateless HTTP mode for multi-worker deployments\nSTATELESS_HTTP=true uv run python main.py\n\n# Deploy with Gunicorn (recommended for production)\nuv pip install gunicorn\nSTATELESS_HTTP=true uv run gunicorn main:app \\\n  -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000\n```\n\n### 🔒 JWT Authentication & Access Control\n```python\n# Tools with security metadata\n@tool(\n    description=\"Query salar…","publisher":null,"homepage":"https://github.com/BrainFiber/viyv_mcp","repository":"https://github.com/BrainFiber/viyv_mcp","version":"2.0.1","license":"MIT","protocols":["mcp"],"tags":["mcp","starlette","uvicorn"],"pricing":null,"endpoints":[{"url":"pypi:viyv-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.882,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"viyv-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:15.129Z","publishedAt":"2026-03-28T02:04:26.855611Z","latestVersion":"2.0.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"viyv-mcp","url":"https://pypi.org/project/viyv-mcp/","firstSeenAt":"2026-09-10T15:23:45.797Z","fetchedAt":"2026-09-10T15:23:45.797Z","normalizedAt":"2026-09-10T15:23:45.797Z"}]},"firstSeenAt":"2026-09-10T15:23:45.797Z","updatedAt":"2026-09-10T15:25:15.129Z"}