FastMCP Demo Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FastMCP Demo Server show me hackathon resources and starter prompts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Demo
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.pyDocker 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:latestRemote MCP (no local setup)
npx -y mcp-remote https://cursor-denver-mcp-hackathon.fastmcp.app/mcpDeployment 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:latestCursor 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 -vProject 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.pyLicense
MIT License
Built for the Cursor Denver Hackathon
Available Tools
1 toolget_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
Scored across 1 tool
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.
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.
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.
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
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
A MCP server built for developers enabling Git based project management with project and personal…
A full backend your AI coding agent can set up over MCP
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA 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.26MIT
- FlicenseBqualityDmaintenanceA 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-
- FlicenseBqualityNot gradedmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceProduction-ready MCP server starter with authentication, observability, and a plugin system for building and deploying MCP servers quickly.MIT