βοΈ
Fastmcp Tunnel Template
GitHub template for FastMCP-based MCP servers with Cloudflare Tunnel + Docker + Terraform
0 installs
Trust: 34 β Low
Cloud
Ask AI about Fastmcp Tunnel Template
Powered by Claude Β· Grounded in docs
I know everything about Fastmcp Tunnel Template. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
MY_MCP_PROJECT
MY_MCP_DESCRIPTION
Architecture
User (Claude, etc.)
β
β MCP (via fastmcp.cloud OAuth proxy)
βΌ
βββββββββββββββββββββββββββββββββββββββββββ
β mcp_server/server.py β
β FastMCP proxy frontend β
β (deployed to fastmcp.cloud) β
β Adds CF Access headers, forwards calls β
βββββββββββββββββββ¬ββββββββββββββββββββββββ
β HTTPS + CF Access service token
βΌ
βββββββββββββββββββββββββββββββββββββββββββ
β Cloudflare Tunnel β
β MY_MCP_SUBDOMAIN.pantainos.net β app:3000 β
βββββββββββββββββββ¬ββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββ
β backend/ (Docker) β
β FastMCP server + business logic β
β βββββββββββββββββββββββββββββββββββ β
β β mcp_tools.py β services/ β β
β βββββββββββββββββββββββββββββββββββ β
βββββββββββββββββββββββββββββββββββββββββββ
Quick Start
# 1. Initialize from template (if not done)
./init.sh
# 2. Configure
cp backend/.env.example .env
# Edit .env with your secrets
# 3. Build + run locally
make build
make up
make health
# 4. Deploy with Cloudflare Tunnel
make deploy
Tools
| Tool | Description |
|---|---|
hello | Example tool (replace me) |
Project Structure
βββ Makefile # Unified command interface
βββ CLAUDE.md # AI assistant operational notes
βββ mcp_server/
β βββ server.py # FastMCP proxy frontend
β βββ pyproject.toml
βββ backend/
β βββ Dockerfile
β βββ docker-compose.yml
β βββ pyproject.toml
β βββ .env.example
β βββ scripts/
β β βββ deploy.sh # Terraform apply + docker up
β β βββ destroy.sh # Docker down + terraform destroy
β β βββ terraformw.sh # Auto-downloading terraform wrapper
β βββ src/MY_MCP_PACKAGE/
β βββ main.py # AppRuntime + FastMCP entry point
β βββ config.py # Settings from environment
β βββ mcp_tools.py # Tool definitions
β βββ services/ # Business logic
βββ terraform/
βββ main.tf # CF Tunnel + DNS + Access
βββ variables.tf
βββ outputs.tf
βββ versions.tf
