Barebones MCP Server
A minimal, dockerized template for creating HTTP-based Model Context Protocol (MCP) servers. This template provides a starting point for building your own MCP tools and services.
Features
HTTP Transport: Ready-to-use HTTP MCP server setup
Docker Support: Containerized deployment with Python 3.13
FastMCP Framework: Built using the FastMCP library for easy MCP server development
Template Structure: Clean, minimal codebase to build upon
What's Included
This template includes a simple get_cat_fact()
tool as an example - replace it with your own tools and functionality.
Quick Start
Build and run the Docker container:
docker build -t mcp-server . docker run -p 8000:8000 mcp-serverConnect in VS Code:
Click the "Start" button on the
.vscode/mcp.json
file that appears in VS CodeThe MCP server will be automatically configured and connected
Access your tools:
Open the Chat panel in VS Code
Click the wrench icon (🔧) to see available MCP tools
Your
get_cat_fact()
tool should appear and be ready to useTest with prompts like:
"Do you see a cat fact mcp tool?"
"Get me a cat fact"
Note: The AI agent should prompt you that it will use an MCP tool before executing it. If you don't see this prompt, the tool isn't being used.
MCP Configuration
Add this to your .vscode/mcp.json
file:
Available Tools (Example)
get_cat_fact()
: Example tool that returns a random cat fact - replace with your own tools
Debugging with MCP Inspector
For debugging and testing your MCP server, you can use the MCP Inspector:
Install and run MCP Inspector:
npx @modelcontextprotocol/inspectorConfigure the connection:
Set transport type to:
httpstreamable
Set URL to:
http://localhost:8000/mcp
Test your tools:
The inspector will show all available tools and their schemas
You can test each tool directly from the web interface
View server capabilities and debug any issues
Customizing the Template
Replace the example tool in
server.py
with your own MCP toolsUpdate dependencies in
requirements.txt
as neededModify the server name in the FastMCP constructor
Add your tool logic using the
@mcp.tool()
decorator
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A minimal, dockerized template for creating HTTP-based Model Context Protocol servers. Provides a starting point with FastMCP framework integration and includes a sample cat fact tool that can be replaced with custom functionality.
Related MCP Servers
- AsecurityAlicenseAqualityA TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.Last updated -1264MIT License
- AsecurityFlicenseAqualityA minimal MCP server template with hot reload support that helps developers quickly set up and build Model Context Protocol servers with example tool implementations.Last updated -3
- -securityAlicense-qualityA template for building Model Context Protocol servers that connect to company REST APIs using FastMCP, providing authentication handling, error management, and example tools for common API operations.Last updated -MIT License
- AsecurityAlicenseAqualityA lightweight framework for building and running Model Context Protocol (MCP) servers using FastMCP, providing tools for development, debugging, and server management.Last updated -4MIT License