python-mcp-server-generator

Generate a Python MCP server project with FastMCP and stdio or HTTP transport.

1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/Gabeujin/workspace-init-mcp --skill python-mcp-server-generator-gabeujin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-mcp-server-generator
Source: https://github.com/Gabeujin/workspace-init-mcp/tree/main/awesome/skills/python-mcp-server-generator
Command: npx skills add https://github.com/Gabeujin/workspace-init-mcp --skill python-mcp-server-generator-gabeujin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of a complete, production-ready Model Context Protocol (MCP) server project in Python, saving developers significant setup time and ensuring best practices are followed from the start.

Core Features & Use Cases

  • Project Scaffolding: Initializes a new Python project with a standard structure using uv.
  • Dependency Management: Automatically includes the mcp[cli] package and sets up a .gitignore.
  • Server Configuration: Configures FastMCP for either stdio or streamable-http transport, with options for HTTP-specific settings.
  • Tool & Resource Generation: Provides a template for creating tools with type hints and docstrings, and optionally for resources and prompts.
  • Code Quality Enforcement: Emphasizes type hints, docstrings, PEP 8 compliance, and async operations.
  • Use Case: A developer needs to quickly set up a new MCP server for a microservice. Instead of manually creating files and configuring dependencies, they use this Skill to generate a robust project structure, ready for tool implementation.

Quick Start

Use the python-mcp-server-generator skill to create a new Python MCP server project named 'my-mcp-service' with stdio transport.

Frequently Asked Questions about python-mcp-server-generator

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

FAQPage Schema
How do I scaffold a Python MCP server project?

To scaffold a Python MCP server project, this generator initializes a standard project structure using `uv`, automatically includes the `mcp[cli]` package, and configures a `.gitignore` file for immediate development readiness.

Does the MCP server generator support HTTP transport?

Yes, the MCP server generator supports HTTP transport by configuring `FastMCP` for `streamable-http` transport, alongside standard `stdio` transport, with specific options available for HTTP-specific server settings.

Can I use async operations and Pydantic models in the generated MCP tools?

Yes, you can use async operations and Pydantic models in the generated MCP tools, as the templates enforce type hints, docstrings, PEP 8 compliance, and provide built-in error handling.

What is the best way to configure FastMCP for a new microservice?

The best way to configure FastMCP for a new microservice is using this generator to produce a production-ready project structure, complete with template tools, resources, and prompts configured for your required transport protocol.

How do I add resources and prompts to an MCP server?

To add resources and prompts to an MCP server, this generator provides optional templates for creating them alongside tool templates, ensuring proper type hints and docstring integration within the project structure.

Do I need uv to generate a Python MCP server?

Yes, you need `uv` to generate a Python MCP server with this tool, as it relies on the package manager to initialize the project structure and handle dependency management for the `mcp[cli]` package.