Cookiecutter MCP UV Container

by daviddrummond95

Not rated
GitHub

About

A Cookiecutter template for creating MCP servers with Apple container support and configurable transport methods.

Details

Author
daviddrummond95
Categories
Developer Tools, Infrastructure, Other

Setup

Install Cookiecutter MCP UV Container in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/daviddrummond95/cookiecutter-mcp-uv-container

Follow the installation instructions in the repository README, then restart your MCP client.

- Superior Security: Each container runs in its own lightweight VM
- macOS Native: Deep integration with macOS frameworks
- On-Demand: Start/stop servers as needed (not constantly running)
- Resource Efficient: Less overhead than traditional VMs
- OCI Compatible: Works with existing container registries

- πŸš€ FastMCP server setup with example tools
- 🐳 Multi-stage Dockerfile for optimized containers
- πŸ“¦ UV package management
- πŸ”’ VM-level isolation with non-root container user
- 🌐 Multiple transport methods (stdio, streamable-http, sse)
- 🍎 Optimized for Apple Silicon
- πŸ“ Example calculator tools with typed parameters

curl -LsSf https://astral.sh/uv/install.sh | sh

Visithttps://github.com/apple/container

- project_name: Human-readable project name (e.g., "My Calculator MCP")
- project_slug: Package name (auto-generated from project_name)
- mcp_name: The MCP server name (e.g., "MyCalculatorMCP")
- description: Project description
- author_name: Your name
- author_email: Your email
- python_version: Python version (default: 3.13)
- mcp_version: MCP SDK version (default: 1.9.4)

After generation, your project will have:

my-mcp-server/ β”œβ”€β”€ Dockerfile # Multi-stage build for containers β”œβ”€β”€ pyproject.toml # UV project configuration β”œβ”€β”€ hello.py # MCP server implementation β”œβ”€β”€ QUICKSTART.md # Quick start guide └── .env.example # Environment configuration
cd my-mcp-server # or whatever you put as project-slug

Start Container System(first time only):

container build --tag my-mcp . # Replace my-mcp with whatever you want to name the container
# Interactive stdio mode container run --interactive my-mcp

Customize: Edithello.pyto add your own MCP tools

For Claude Desktop, you have two options:

Option 1: Run locally without container (recommended for development)

{ "mcpServers": { "My MCP Server (Local)": { "command": "uv", "args": ["run", "fastmcp", "/path/to/my-mcp-server/hello.py"] } } }

Option 2: Use HTTP transport with container

Then configure Claude Desktop to connect via STDIO:

{ "mcpServers": { "My MCP Server (Container)": { "command": "container", "args": ["run", "--interactive", "my-mcp-container"] } } }

The template supports multiple transport methods via environment variables:

- stdio: Default
- More in progress for flow from local-> cloud

Set via:MCP_TRANSPORT=<transport-type>

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

MCP server that gives LLMs full control over local Kubernetes dev environments via k3d, kubectl, Tilt, Helm, and kustomize

A base template for creating new MCP servers, designed for easy containerized deployment with Docker.

Official Docker MCP Toolkit for discovering, configuring, and running containerized MCP servers through Docker Desktop and the Docker MCP gateway.

The Octopus MCP Server provides your AI assistant with powerful tools that allow it to inspect, query, and diagnose problems within your Octopus instance, transforming it into your ultimate DevOps wingmate.

The Railway MCP Server enables natural language interaction with your Railway projects and infrastructure. Ask your IDE or AI assistant to create projects, deploy templates, manage environments, pull variables, redeploy services, and more.

The Shipyard CLI provides an MCP server for agents to manage Shipyard environments directly: by pulling logs, comparing branches, running tests, and stopping/starting environments..

HashiCorp Terraform MCP server for Infrastructure as Code workflows, including provider and module discovery through the Terraform Registry.

MCP server for managing Unleash feature flags and automate best practices.

A secure, Docker-based server providing core execution capabilities for AI agents.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.