Skip to main content
Glama
FastMCP Demo Server

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.

Related MCP server: FastMCP Server Template

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

Available Tools

1 tool
get_hackathon_infoA

Get the complete hackathon overview with all information about the MCP Server Hackathon.

Returns: The full hackathon overview document including format, getting started guide, project ideas, resources, and quick reference.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently maintains perfect naming consistency, as there are no other tools to compare against. The name 'get_hackathon_info' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for a server's purpose, as it severely limits functionality and scope. This feels thin and inadequate for handling even basic operations beyond a single read action.

    Completeness2/5

    The server is severely incomplete, offering only a read operation for hackathon information. There are no tools for creating, updating, or deleting data, nor for interacting with other aspects of a hackathon domain, leading to significant gaps.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A production-ready development scaffold for MCP servers, optimized for Cursor IDE with built-in tools, resources, and prompts that enables quick development of Model Context Protocol servers with 5-minute startup and 10-minute development capabilities.
      26
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A production-ready MCP server template that enables developers to quickly build and deploy MCP servers with dynamic tool/resource loading, YAML-based prompts, and seamless OpenShift deployment. Supports both local development with hot-reload and production HTTP deployment with optional JWT authentication.
      1
      -
    • F
      license
      B
      quality
      Not graded
      maintenance
      A production-ready FastMCP server template with modular architecture for building MCP servers with organized tools, resources, and prompts, featuring container support and AI agent documentation system.
      3
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Production-ready MCP server starter with authentication, observability, and a plugin system for building and deploying MCP servers quickly.
      MIT