Skip to main content
Glama
dganesh5

Mock MCP Apps Server

by dganesh5
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Mock MCP Apps Server

A local, no-auth FastAPI + FastMCP server exposing MCP over Streamable HTTP at POST /v1/mcp, with a React 18 + Vite widget frontend built on @modelcontextprotocol/ext-apps.

Two mocked tools:

  • get_weather_forecast — returns a mocked 5-day forecast and renders an interactive widget.

  • list_supported_cities — plain text list of mocked cities (no widget).

No auth of any kind. Intended for local development and testing against MCP hosts (ChatGPT dev mode, Claude, MCP Inspector) via a tunnel like ngrok.

Quickstart

poetry install
cd app/web && npm install && npm run build && cd ../..
./start_mcp.sh

This starts:

Port

What

8000

FastAPI + MCP (/v1/mcp, /health, /apidoc/swagger)

4444

Static widget assets (CORS-enabled)

To expose it to a remote MCP host:

ngrok http 8000

Then add https://<your-ngrok-domain>/v1/mcp as a custom connector in the host.

Related MCP server: weather mcp

Smoke test

curl -s http://localhost:8000/health

curl -s -X POST http://localhost:8000/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

See docs/MOCK_MCP_APP_RECREATION_GUIDE.md for the full spec this project implements.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-weather

    minwoo129
    F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server built with the mcp-framework to provide weather-related tools and data to AI clients. It enables integration of weather capabilities and custom tools into the MCP ecosystem for use with platforms like Claude Desktop.
    7 npm
    -

  • weather mcp

    Tarun-004
    F
    license
    Not graded
    quality
    D
    maintenance
    A lightweight Model Context Protocol (MCP) server that gives AI assistants the ability to fetch real-time weather data for any city using the OpenWeatherMap API.
    1
    -

  • weather-mcp-server

    ariz-ahmad
    A
    license
    Not graded
    quality
    C
    maintenance
    A no-API-key-required MCP server that wraps Open-Meteo APIs to provide geocoding and weather forecast data, enabling city lookups and multi-day forecasts through tools, resources, and prompts.
    MIT