Flappy Bird

You can run a fully playable Flappy Bird game inline in your AI chat clients using MCP Apps. This MCP server hosts the game, exposes a simple HTTP endpoint, and provides tools to play, submit scores, and fetch the high score for your session.

How to use

To use this MCP server, start the local server and connect through an MCP client or an external tunnel for remote access. You can render the game inline in supported chat interfaces and interact with the built-in tools to play, save your score, and retrieve the top score for your session.

How to install

Prerequisites: you need a JavaScript runtime and package manager. This project uses Bun for installation and execution.

bun install
bun run build

Other setup and run details

Run the MCP server locally. It serves the MCP endpoint at the following path.

bun run serve

Expose via tunnel for remote access

If you want to access the MCP endpoint from remote chat clients, expose it with a tunnel and use the generated URL as your MCP server endpoint.

cloudflared tunnel --url http://localhost:3001

Configured endpoints for clients

Use the tunnel URL provided to connect from ChatGPT or Claude AI. You will then point your MCP client to the tunnel endpoint.

Usage with MCP clients

In supported MCP clients, you can load the game as an app and then use the built-in tools to interact with the game.

Tools

The MCP server offers three tools to interact with the game.

Available tools

play-flappy-bird

Launches the game and renders it inline in the MCP client.

submit-score

Submits your in-game score from the game UI to the server.

get-high-score

Returns the session high score from the server.