Skip to main content
Glama

FastMCP Demo Server

by apoojary94

MCP Demo

Python 3.12+ FastMCP Docker License: MIT

A production-ready FastMCP reference server with hackathon resources and reusable starter prompts


Overview

A FastMCP server with comprehensive hackathon overview resources and reusable starter prompts. Clone, install dependencies or build the Docker image, and you have an MCP server that Cursor can load immediately.

Requirements

Component

Version

Required

Python

3.12+

Yes

uv

Latest

Yes

Docker

24+

Optional

Node.js

18+

Optional


Quick Start

Local Python Setup

# Install dependencies and run uv sync uv run server.py

Docker Setup

# Build the image docker build -t mcp-demo:latest . # Run the container docker run --rm -i mcp-demo:latest # Development mode with live reload docker run --rm -it -v "$(pwd)":/app mcp-demo:latest

Remote MCP (no local setup)

npx -y mcp-remote https://cursor-denver-mcp-hackathon.fastmcp.app/mcp

Deployment Options

Mode

Use Case

Setup

Best For

Local STDIO

Cursor integration

Simple

Development

Remote HTTP/SSE

Public access

Advanced

Production

Docker Local

Isolated environment

Medium

Testing

Docker Remote

Cloud deployment

Advanced

Production

Container Registry Push

# GitHub Container Registry docker tag mcp-demo:latest ghcr.io/<your-user>/mcp-demo:latest docker push ghcr.io/<your-user>/mcp-demo:latest # Docker Hub docker tag mcp-demo:latest <your-user>/mcp-demo:latest docker push <your-user>/mcp-demo:latest

Cursor Configuration

Add to ~/.cursor/mcp.json:

{ "mcpServers": { "fastmcp-demo": { "command": "uv", "args": ["run", "server.py"], "cwd": "/absolute/path/to/mcp-demo" } } }
{ "mcpServers": { "fastmcp-demo": { "command": "docker", "args": [ "run", "--rm", "-i", "--volume", "/absolute/path/to/mcp-demo:/app", "mcp-demo" ] } } }

Remote MCP Server

{ "mcpServers": { "denver-hackathon": { "command": "npx", "args": [ "-y", "mcp-remote", "https://cursor-denver-mcp-hackathon.fastmcp.app/mcp" ] } } }

Restart Cursor after updating configuration.


Testing

# Run all tests pytest # Run with coverage pytest --cov=. --cov-report=html # Run specific test pytest tests/test_server.py -v

Project Structure

mcp-demo/ ├── server.py # FastMCP server ├── main.py # Alternative entry point ├── Dockerfile # Container build ├── requirements.txt # Dependencies ├── pyproject.toml # Project config ├── resources/ │ └── hackathon_overview.md ├── prompts/ │ └── fastmcp_python_starter.md └── tests/ ├── conftest.py └── test_server.py

License

MIT License


Built for the Cursor Denver Hackathon

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A production-ready MCP server that provides hackathon resources and reusable starter prompts. Built with FastMCP framework and includes comprehensive deployment options for development and production environments.

  1. Overview
    1. Requirements
      1. Quick Start
        1. Local Python Setup
        2. Docker Setup
        3. Remote MCP (no local setup)
      2. Deployment Options
        1. Container Registry Push
      3. Cursor Configuration
        1. Remote MCP Server
      4. Testing
        1. Project Structure
          1. License

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/apoojary94/mcp_hackathon'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server