Skip to content
Skills Library
AI & agents · Building & coding

fai-mcp-python-generator

/fai-mcp-python-generator

Scaffold a production-ready Python MCP server — FastMCP decorators, async tools, structured outputs, and Azure integration. USE FOR: building a new MCP server in Python, exposing tools/resources to an LLM, wiring FastMCP, adding Azure-backed MCP tools, stdio or HTTP transport. DO NOT USE FOR: TypeScript/Node MCP servers (use the TS generator), MCP client code, non-MCP REST APIs, consuming existing MCP servers. Triggers: "mcp server", "fastmcp", "python mcp", "model context protocol", "expose tools", "build an mcp", "tool server".

Repository
frootai ↗
Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Scaffold a production-ready Python MCP server — FastMCP decorators, async tools, structured outputs, and Azure integration. USE FOR: building a new MCP server in Python, exposing tools/resources to an LLM, wiring FastMCP, adding Azure-backed MCP tools, stdio or HTTP transport. DO NOT USE FOR: TypeScript/Node MCP servers (use the TS generator), MCP client code, non-MCP REST APIs, consuming existing MCP servers. Triggers: "mcp server", "fastmcp", "python mcp", "model context protocol", "expose tools", "build an mcp", "tool server".

Triggers from the description

mcp serverfastmcppython mcpmodel context protocolexpose toolsbuild an mcptool server
Original author description

Scaffold a production-ready Python MCP server — FastMCP decorators, async tools, structured outputs, and Azure integration. USE FOR: building a new MCP server in Python, exposing tools/resources to an LLM, wiring FastMCP, adding Azure-backed MCP tools, stdio or HTTP transport. DO NOT USE FOR: TypeScript/Node MCP servers (use the TS generator), MCP client code, non-MCP REST APIs, consuming existing MCP servers. Triggers: "mcp server", "fastmcp", "python mcp", "model context protocol", "expose tools", "build an mcp", "tool server".

How it works

  1. Overview
  2. Parameters
  3. Steps
  4. Output
  5. WAF Alignment
  6. Compatible Solution Plays
  7. Error Handling
  8. Usage
  9. Configuration Reference
  10. Monitoring
Original SKILL.md headings · 156 lines, 647 words
SKILL.md preview
---
name: fai-mcp-python-generator
description: |
  Scaffold a production-ready Python MCP server — FastMCP decorators, async tools, structured outputs, and Azure integration.
  USE FOR: building a new MCP server in Python, exposing tools/resources to an LLM, wiring FastMCP, adding Azure-backed MCP tools, stdio or HTTP transport.
  DO NOT USE FOR: TypeScript/Node MCP servers (use the TS generator), MCP client code, non-MCP REST APIs, consuming existing MCP servers.
  Triggers: "mcp server", "fastmcp", "python mcp", "model context protocol", "expose tools", "build an mcp", "tool server".
waf: ["Security", "Reliability", "Performance Efficiency", "Operational Excellence"]
plays: ["29-mcp-platform-integration", "01-enterprise-rag", "21-agentic-rag"]
---

# Fai Mcp Python Generator

name: fai-mcp-python-generator

## Overview

This skill provides a structured, repeatable procedure for scaffolding a production-ready Python MCP server with FastMCP decorators, async tools, structured outputs, and Azure integration. It can be used standalone as a LEGO block or auto-wired inside solution plays via the FAI Protocol.

**Category:** MCP Integration
**Complexity:** Medium
**Estimated Time:** 10-30 minutes

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `target` | string | Yes | — | Target resource, file, or endpoint |
| `environment` | enum | No | `dev` | Target environment: `dev`, `staging`, `prod` |
| `verbose` | boolean | No | `false` | Enable detailed output logging |
| `dry_run` | boolean | No | `false` | Validate without making changes |
| `config_path` | string | No | `config/` | Path to configuration directory |

## Steps

### Step 1: Validate Prerequisites

Verify all required tools, credentials, and dependencies are available.

```bash
# Check required tools
command -v node >/dev/null 2>&1 || { echo 'Node.js required'; exit 1; }
command -v az >/dev/null 2>&1 || { echo 'Azure CLI required'; exit 1; }
```

### Step 2: Load Configuration

Read settings from the FAI manifest and TuneKit config files.

```bash
# Load from fai-manifest.json if inside a play
CONFIG_DIR="${config_path:-config}"
if [ -f "fai-manifest.json" ]; then
  echo "FAI Protocol detected — auto-wiring context"
fi
```

### Step 3: Execute Core Logic

Perform the primary operation: name: fai-mcp-python-generator.

### Step 4: Validate Results

Verify the output meets quality thresholds and WAF compliance.

```bash
# Validate output
if [ "$?" -eq 0 ]; then
  echo "✅ Skill completed successfully"
else
  echo "❌ Skill failed — check logs"
  exit 1
fi
```

## Output

| Output | Type | Description |
|--------|------|-------------|
| `status` | enum | `success`, `warning`, `failure` |
| `duration_ms` | number | Execution time in milliseconds |
| `artifacts` | string[] | List of generated/modified files |
| `logs` | string | Detailed execution log |

## WAF Alignment

| Pillar | How This Skill Contributes |
|--------|---------------------------|
| performance-efficiency | Optimizes for speed, uses caching, supports parallel execution |
| reliability | Includes retry logic, validates outputs, provides rollback steps |

## Compatible Solution Plays

- **Play 29**

## Error Handling

| Exit Code | Meaning | Action |
|-----------|---------|--------|
| 0 | Success | Proceed to next step |
| 1 | Validation failure | Check input parameters |
| 2 | Dependency missing | Install required tools |
| 3 | Runtime error | Check logs, retry with `--verbose` |

## Usage

### Standalone

```bash
# Run this skill directly
npx frootai skill run fai-mcp-python-generator
```

### Inside a Solution Play

When referenced in `fai-manifest.json`, this skill auto-wires with the play's context:

```json
{
  "primitives": {
    "skills": ["skills/fai-mcp-python-generator/"]
  }
}
```

### Via Agent Invocation

Agents can invoke this skill using the `/skill` command in Copilot Chat.

## Configuration Reference

```json
{
  "skill": "skill-name",
  "version": "1.0.0",
  "timeout_seconds": 300,
  "retry_attempts": 3,
  "log_level": "info"
}
```

## Monitoring

Track skill execution metrics:

| Metric | Description | Alert Threshold |
|--------|-------------|----------------|
| Duration | Execution time | > 60 seconds |
| Success rate | Pass/fail ratio | < 95% |
| Error count | Failed executions | > 5/hour |

## Troubleshooting

| Symptom | Cause | Fix |
|---------|-------|-----|
| Timeout | Slow dependency | Increase timeout_seconds |
| Auth failure | Expired credentials | Refresh Managed Identity |
| Missing config | No fai-manifest.json | Create manifest or pass config_path |
| Validation error | Invalid input | Check parameter types and ranges |

## Notes

- This skill follows the FAI SKILL.md specification
- All outputs are deterministic when `dry_run=true`
- Integrates with FAI Engine for automated pipeline execution
- Part of the MCP Integration category in the FAI primitives catalog
Files in this package (3)
  • SKILL.lean.md 5 KB
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB

Versions

The database has no other skills named fai-mcp-python-generator.

Database snapshot: 13.11.2026 · package version 20a985f212a8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100mcp-python
    Create and extend MCP (Model Context Protocol) servers in Python using FastMCP and the official SDK. Covers tools, resources, prompts, STDIO vs HTTP transports, logging rules for STDIO, and production best practices. Use when building or modifying MCP servers in Python, adding…
  • 100fastmcp
    FastMCP is a Python framework for building Model Context Protocol (MCP) servers and clients: a decorated Python function becomes a tool, resource or prompt that an AI agent can call, with the schema generated from type hints. Use when someone asks to "build an MCP server in…
  • 100fastmcp
    Build, test, inspect, install, and deploy MCP servers with FastMCP in Python. Use when creating a new MCP server, wrapping an API or database as MCP tools, exposing resources or prompts, or preparing a FastMCP server for Claude Code, Cursor, or HTTP deployment.
  • 98fastmcp-server
    Complete guide for building MCP servers with FastMCP 3.0 - tools, resources, authentication, providers, middleware, and deployment. Use when creating Python MCP servers or integrating AI models with external tools and data.
  • 100mcp-server-authoring
    FastMCP authoring for Python MCP servers — tools, resources, prompts, TDD, release-please. Use when building or extending an MCP server, adding a tool/resource, or scaffolding a new server.
  • 100mcp-server-dev
    Create MCP servers — multi-tool services exposed via Model Context Protocol. Use this skill whenever users mention MCP servers, building servers, server scaffolding, tool registration, or want to package tools for distribution via uvx or npx. Also use when the conversation…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.