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".
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
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
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
- Overview
- Parameters
- Steps
- Output
- WAF Alignment
- Compatible Solution Plays
- Error Handling
- Usage
- Configuration Reference
- Monitoring
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…