Skip to main content
Glama
Sign In
Mock MCP Apps Server

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    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.
      13 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