mcp-structure

Generate standardized project scaffolds for Python and TypeScript MCP servers.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Hashzin-0/Curion --skill mcp-structure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-structure
Source: https://github.com/Hashzin-0/Curion/tree/main/.opencode/skills/mcp-structure
Command: npx skills add https://github.com/Hashzin-0/Curion --skill mcp-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about mcp-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a Python MCP server project with a consistent directory structure?

To scaffold a Python MCP server, generate a standardized directory layout including src, tools, models, services, security, and tests. This ensures layered organization and maintainability by providing pyproject configuration, type hints, and pytest structures.

Can I use this to generate TypeScript MCP server templates with Docker and CI artifacts?

Yes, you can generate TypeScript MCP server templates that include tsconfig, Dockerfile, docker-compose, and CI artifacts. This standardizes deployments and ensures deployability through non-root container practices and configuration templates.

What is the best way to organize an MCP server architecture for multiple teams?

The best way to organize MCP server architectures for multiple teams is using an opinionated project scaffold. It enforces consistent layouts, naming conventions, mandatory type hints, and logging guidelines to eliminate ad-hoc layouts and ensure code quality.

Does this MCP scaffold include security best practices and deployment checklists?

Yes, the MCP scaffold includes security best practices and deployment readiness checklists. It provides non-root container practices in Docker templates and CI preparation guidelines to ensure secure and maintainable deployments.

Why do I need a standardized scaffold for initializing new MCP backend services?

You need a standardized scaffold for initializing new MCP backend services to speed up project bootstrapping. It eliminates ad-hoc layouts by providing repeatable templates for configuration, testing scaffolds, and code style rules.