The repository you cloned has everything you need to start building your MCP server—authentication, deployment configuration, and a ready-to-use project structure. Here’s what’s inside and where to find things.
Overview
When you create a server, Gumstack generates this structure:
your-server/├── config.yaml # Server metadata and tool declarations├── src/│ ├── server.py # FastMCP server and tool definitions│ └── utils/│ └── auth.py # get_credentials() helper├── tests/ # pytest tests├── .env # Local environment variables└── pyproject.toml # Dependencies
File
Purpose
config.yaml
Declares your server’s name, auth type, and which tools to expose
src/server.py
Where you define your tools using FastMCP
src/utils/auth.py
Helper for retrieving user credentials
.env
Local environment variables for development
pyproject.toml
Python dependencies managed by uv or pip
gumstack-mcp is a fork of the official MCP Python
SDK. All upstream
features are supported, including both
FastMCP (high-level) and the
low-level Server API.
config.yaml
Server configuration and tool declarations. Tools must be listed here to be detected by Gumstack.