mcpsvr

Maintains a single authoritative servers.json file that defines all available MCP servers, their execution commands, configuration schemas, and runtime parameters. The registry uses a hub-and-spoke architecture where this central JSON file serves as the source of truth consumed by both the web application frontend and external MCP clients, enabling standardized server discovery and configuration across the ecosystem.

Supports execution of MCP servers across multiple runtime environments (Node.js via npx, Python via uvx/python, and direct command execution) by storing runtime-agnostic command templates in the registry. Each server definition includes a command string that specifies the execution method, and the system resolves parameters at runtime to generate the final executable command, enabling servers written in different languages to coexist in a unified directory.

Enables dynamic server configuration by defining user-facing parameters using a template syntax ({{paramName@paramType::description}}) that gets resolved at installation time. The system parses parameter definitions from server configurations, presents them to users through the web interface, collects their values, and substitutes them into command templates before execution, supporting API keys, file paths, and other runtime-specific configuration.

Provides a Next.js-based web application that consumes the servers.json registry and renders a searchable, filterable interface for discovering MCP servers. The application implements full-text search across server names and descriptions, category-based filtering, and a details dialog showing complete server metadata, enabling users to browse and understand available servers before installation.

Generates deep links using the app.5ire:// protocol that encode server configuration and parameters, allowing users to click an install button in the web UI and automatically trigger installation in compatible MCP clients (like 5ire). The system constructs deep links by serializing server metadata and resolved parameters into a URI that the client application can parse and execute.

Implements a community-driven contribution model where developers submit new MCP servers by creating pull requests against the public/servers.json file. The system provides contribution guidelines, schema validation, and a review process that ensures quality control before servers are added to the registry, enabling decentralized community participation while maintaining data integrity.

Defines a standardized JSON schema for server entries that includes name, description, command template, parameter definitions, tags, and other metadata. Each server entry follows this schema, enabling consistent parsing and presentation across the web UI and client applications. The schema documentation provides clear guidance on required fields, parameter syntax, and configuration patterns.

Implements OpenGraph and meta tags in the Next.js app/layout.tsx to optimize the web application for search engine indexing and social media sharing. The metadata includes title, description, and image tags that enable rich previews when the MCPSvr site is shared on social platforms, improving discoverability and click-through rates from external sources.

Provides a set of reusable React UI components (main interface, search dialog, server details modal, hero section) with a global styling system and design tokens for consistent theming. The component library enables rapid development of the web interface while maintaining visual consistency, with support for responsive design across different screen sizes.