MCP App Store 🏪

A multi-app hosting platform for MCP (Model Context Protocol) applications. Deploy multiple AI-powered apps from a single server with shared infrastructure, security, and routing.

🎯 What Is This?

MCP App Store is a hosting platform that lets you:

• 🚀 Deploy multiple MCP apps from a single server
• 🔐 Shared API key authentication across all apps
• 🛤️ Automatic routing: /{app-id}/mcp for each app
• 📦 Single deployment to Railway/Vercel/any host
• 🔧 Easy to add new apps - just create a folder!

🌐 Live Platform

Production URL: https://mcp-production-3a5e.up.railway.app

Available Apps

📄 Document Reader Vision (PDF Insight)

Goal: a scalable, client-agnostic document reader that works inside any AI host. Users can open documents, read them in-app, and use AI actions (explain, summarize, translate, annotate) with persistent memory and personalization.

MVP approach:

• Local-only storage for notes and settings
• Single-document focus with selection-based quick actions
• Build for portability, then swap the storage/auth layer

Scale-up plan:

• Supabase for auth, database, and file storage
• Multi-device sync and team collaboration
• Vector memory for semantic search across notes and documents

🔌 Connect to Claude Desktop / VS Code

{
  "servers": {
    "recipe-remix": {
      "type": "sse",
      "url": "https://mcp-production-3a5e.up.railway.app/recipe-remix/mcp"
    },
    "allocation-remix": {
      "type": "sse",
      "url": "https://mcp-production-3a5e.up.railway.app/allocation-remix/mcp"
    },
    "pdf-insight": {
      "type": "sse",
      "url": "https://mcp-production-3a5e.up.railway.app/pdf-insight/mcp"
    }
  }
}

🏗️ Architecture

mcp-app/
├── main.ts              # Multi-app server with routing & auth
├── app-registry.ts      # App registration system
├── apps/                # 📁 Each app lives here
│   └── recipe-remix/    # Example app
│       ├── server.ts    # Tool & resource registration
│       ├── mcp-app.tsx  # React UI entry
│       └── README.md    # App-specific docs
├── dist/                # Built HTML bundles
├── package.json
└── vite.config.ts

How Routing Works

Request: GET /recipe-remix/mcp
              ↓
main.ts routes to apps/recipe-remix/server.ts
              ↓
App handles MCP protocol (tools, resources, UI)
              ↓
Response returned to client

➕ Adding a New App

1. Create app folder:

   mkdir -p apps/my-new-app/src
   

2. Create server.ts with your tools:

   import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
   
   export function registerTools(server: McpServer) {
     server.tool("my-tool", { /* schema */ }, async (params) => {
       // Your tool logic
     });
   }
   

3. Create mcp-app.tsx for the UI:

   import React from "react";
   
   export default function App({ data }) {
     return <div>{/* Your UI */}</div>;
   }
   

4. Register in app-registry.ts:

   export const apps = {
     "recipe-remix": { /* ... */ },
     "my-new-app": {
       name: "My New App",
       description: "Does something cool",
       path: "./apps/my-new-app/server.ts"
     }
   };
   

5. Add Vite build config in vite.config.ts

6. Build and test:

   npm run build
   npx tsx main.ts
   

🔧 Local Development

# Install dependencies
npm install

# Build all apps
npm run build

# Start the server
npx tsx main.ts

# Server runs at http://localhost:3001
# Apps available at http://localhost:3001/{app-id}/mcp

Test an App Locally

{
  "servers": {
    "recipe-remix": {
      "type": "sse",
      "url": "http://localhost:3001/recipe-remix/mcp"
    }
  }
}

🚢 Deployment

Deployed on Railway with automatic builds:

railway up

Environment Variables

🔒 Security

• API Key Validation - Optional - set API_KEY env var to enable auth via ?apiKey= or Bearer header
• CSP Support - Apps can configure Content Security Policy for external resources
• CORS Enabled - Cross-origin requests supported for browser clients

🎨 Tech Stack

• Server: Express + MCP SDK with StreamableHTTPServerTransport
• Frontend: React 18, TypeScript, CSS Modules (plus vanilla for example-based apps)
• Icons: Lucide React (tree-shakable SVGs)
• Animations: Lottie React
• Bundler: Vite + vite-plugin-singlefile
• Deployment: Railway
• Planned: Supabase (Auth, Postgres, Storage)

📜 MCP Protocol

This platform implements the Model Context Protocol:

• Tools - Functions the AI can call (e.g., show-recipe)
• Resources - Data/UI the AI can display
• Transports - SSE for streaming, HTTP for request/response

Each app defines its own tools and resources, the platform handles:

• Protocol negotiation
• Session management
• Authentication
• Routing

🗺️ Roadmap

• More apps (Weather, Maps, Stocks, etc.)
• App discovery endpoint
• Usage analytics
• Rate limiting
• App versioning
• PDF Insight: notes with inline save dialog (local SQLite)
• PDF Insight: test suite (Vitest — URL helpers + DB repository)
• PDF Insight: highlights UI (DB schema ready)
• PDF Insight: configurable quick actions (summarize/translate/define)
• PDF Insight: per-profile preferences and per-document settings
• PDF Insight: Supabase-backed auth, DB, and storage
• PDF Insight: vector search across notes/documents

📝 License

MIT

Built with ❤️ using the MCP SDK