mcp-structure

What problem does it solve?

Provides a repeatable, opinionated project scaffold and templates for MCP servers to eliminate ad-hoc layouts, speed up project bootstrapping, and enforce maintainability, testing, and security best practices.

Core Features & Use Cases

• Directory scaffolds for Python and TypeScript MCP servers with layered organization (tools, models, services, security, utils).
• Templates and config including example main/server files, pyproject/tsconfig, Dockerfile, docker-compose, and config.yaml to standardize deployments.
• Code standards and tests with naming conventions, mandatory type hints, docstring guidelines, logging, and a pytest structure to ensure code quality.
• Deployment readiness with Docker templates, non-root container practices, and a checklist for security and CI preparation.
• Use cases: initialize a new MCP backend, create consistent templates for multiple teams, or generate a GitHub-integrated MCP scaffold ready for deployment.

Quick Start

Create a new Python MCP server scaffold named github-mcp that includes src tools models services security tests a Dockerfile config and CI templates.