MCP Scaffold
timothywarner-org/claude-code
Scaffold production-ready Python MCP servers using FastMCP. An agent skill from timothywarner-org/claude-code.
Generate a complete MCP server project in Python with tools, resources, and proper configuration
Install Python MCP Server Generator
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install github/awesome-copilot python-mcp-server-generator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/python-mcp-server-generator .claude/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .claude/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install github/awesome-copilot python-mcp-server-generator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/python-mcp-server-generator .agents/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .agents/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install github/awesome-copilot python-mcp-server-generator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/python-mcp-server-generator .cursor/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .cursor/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/github/awesome-copilot.git --path skills/python-mcp-server-generator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install github/awesome-copilot python-mcp-server-generator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/python-mcp-server-generator .gemini/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .gemini/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install github/awesome-copilot python-mcp-server-generatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/python-mcp-server-generator .github/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .github/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add github/awesome-copilot --skill python-mcp-server-generator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install github/awesome-copilot python-mcp-server-generator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/python-mcp-server-generator .opencode/skills/python-mcp-server-generator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "python-mcp-server-generator" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/python-mcp-server-generator into .opencode/skills/python-mcp-server-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-mcp-server-generator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
python-mcp-server-generator- GitHub stars
- 40k
- Used in
- 1 other repo
- Token cost
- ~990 tokens
- SKILL.md length
- 477 words
- Files
- 1
- Skills in repo
- 417
- Repo updated
- First seen
- Licence
- MIT
At a glance
Generate a complete MCP server project in Python with tools, resources, and proper configuration
- Works in 5 steps: Project Structure: Create a new Python… → Dependencies: Include mcp[cli] package… → Transport Type: Choose between stdio… → …
- Tasks that involve MCP servers
- SKILL.md covers Requirements, Implementation Details, Example Tool Types to Consider and Configuration Options, plus 3 more sections
- Calls uv and python
What it does
Python MCP Server Generator is an agent skill from github/awesome-copilot, published by the product's own GitHub organization. Generate a complete MCP server project in Python with tools, resources, and proper configuration
Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and Python. The repository describes itself as: Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot. The licence is MIT.
When your agent uses it
- Tasks that involve MCP servers
Example prompts
- “/python-mcp-server-generator”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Project Structure: Create a new Python project with proper structure using uv
- Dependencies: Include mcp[cli] package with uv
- Transport Type: Choose between stdio (for local) or streamable-http (for remote)
- Tools: Create at least one useful tool with proper type hints
- Error Handling: Include comprehensive error handling and validation
What it can do on your machine
Read from SKILL.md and the folder at commit 727ff2e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uvpython
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Python MCP Server Generator loads about 990 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 477 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from github/awesome-copilot at commit 727ff2e, republished under its MIT licence (© github). 477 words, ~990 tokens.
Download SKILL.mdSave it as
.claude/skills/python-mcp-server-generator/SKILL.md (or your agent's skills folder).- name
- python-mcp-server-generator
- description
- Generate a complete MCP server project in Python with tools, resources, and proper configuration
Generate Python MCP Server
Create a complete Model Context Protocol (MCP) server in Python with the following specifications:
Requirements
- Project Structure: Create a new Python project with proper structure using uv
- Dependencies: Include mcp[cli] package with uv
- Transport Type: Choose between stdio (for local) or streamable-http (for remote)
- Tools: Create at least one useful tool with proper type hints
- Error Handling: Include comprehensive error handling and validation
Implementation Details
Project Setup
- Initialize with
uv init project-name - Add MCP SDK:
uv add "mcp[cli]" - Create main server file (e.g.,
server.py) - Add
.gitignorefor Python projects - Configure for direct execution with
if __name__ == "__main__"
Server Configuration
- Use
FastMCPclass frommcp.server.fastmcp - Set server name and optional instructions
- Choose transport: stdio (default) or streamable-http
- For HTTP: optionally configure host, port, and stateless mode
Tool Implementation
- Use
@mcp.tool()decorator on functions - Always include type hints - they generate schemas automatically
- Write clear docstrings - they become tool descriptions
- Use Pydantic models or TypedDicts for structured outputs
- Support async operations for I/O-bound tasks
- Include proper error handling
Resource/Prompt Setup (Optional)
- Add resources with
@mcp.resource()decorator - Use URI templates for dynamic resources:
"resource://{param}" - Add prompts with
@mcp.prompt()decorator - Return strings or Message lists from prompts
Code Quality
- Use type hints for all function parameters and returns
- Write docstrings for tools, resources, and prompts
- Follow PEP 8 style guidelines
- Use async/await for asynchronous operations
- Implement context managers for resource cleanup
- Add inline comments for complex logic
Example Tool Types to Consider
- Data processing and transformation
- File system operations (read, analyze, search)
- External API integrations
- Database queries
- Text analysis or generation (with sampling)
- System information retrieval
- Math or scientific calculations
Show full SKILL.md (203 more words)Show less
Configuration Options
For stdio Servers:
- Simple direct execution
- Test with
uv run mcp dev server.py - Install to Claude:
uv run mcp install server.py
For HTTP Servers:
- Port configuration via environment variables
- Stateless mode for scalability:
stateless_http=True - JSON response mode:
json_response=True - CORS configuration for browser clients
- Mounting to existing ASGI servers (Starlette/FastAPI)
Testing Guidance
- Explain how to run the server:
- stdio:
python server.pyoruv run server.py - HTTP:
python server.pythen connect tohttp://localhost:PORT/mcp
- stdio:
- Test with MCP Inspector:
uv run mcp dev server.py - Install to Claude Desktop:
uv run mcp install server.py - Include example tool invocations
- Add troubleshooting tips
Additional Features to Consider
- Context usage for logging, progress, and notifications
- LLM sampling for AI-powered tools
- User input elicitation for interactive workflows
- Lifespan management for shared resources (databases, connections)
- Structured output with Pydantic models
- Icons for UI display
- Image handling with Image class
- Completion support for better UX
Best Practices
- Use type hints everywhere - they're not optional
- Return structured data when possible
- Log to stderr (or use Context logging) to avoid stdout pollution
- Clean up resources properly
- Validate inputs early
- Provide clear error messages
- Test tools independently before LLM integration
Generate a complete, production-ready MCP server with type safety, proper error handling, and comprehensive documentation.
© github, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/python-mcp-server-generator of github/awesome-copilot.
Open the folder on GitHubat commit 727ff2e
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in github/awesome-copilot, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Python MCP Server Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Python MCP Server Generator this skillgithub/awesome-copilot | 40k | 1 repos | ~990 | Automated safety check: Pass | MIT | |
| MCP Scaffoldtimothywarner-org/claude-code | 224 | — | ~940 | Automated safety check: Pass | MIT | |
| Open PRArcadeAI/arcade-mcp | 1k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Packet TracerMats2208/MCP-Packet-Tracer | 241 | — | ~6.8k | Automated safety check: Pass | MIT | |
| MCP DeveloperJeffallan/claude-skills | 12k | — | ~1.5k | Automated safety check: Pass | MIT | |
| MCP Server Builderanthropics/skills | 180k | 62 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Open PR
ArcadeAI/arcade-mcp
Prepare arcade-mcp changes for review by verifying intended behavior, filling the repository PR template, and creating or updating the PR.
Packet Tracer
Mats2208/MCP-Packet-Tracer
A skill your agent uses when building, automating, or debugging Cisco Packet Tracer networks through the packet-tracer MCP (the pt tools) — planning topologies from natural language, live-deploying…
MCP Developer
Jeffallan/claude-skills
Builds and debugs MCP servers and clients in TypeScript or Python, from tool and resource definitions to transport setup and inspector-based protocol checks.
- Official
MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
More from github/awesome-copilot
All 417 skills in this repo- Official
Acquire Codebase Knowledge
github/awesome-copilot
Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.
- Official
Azure Architecture Autopilot
github/awesome-copilot
Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.
- Official
Draw.io Diagram Generator
github/awesome-copilot
Generates, edits and validates draw.io files with correct mxGraph XML, covering flowcharts, architecture, sequence, ER and UML class diagrams.
- Official
Credit Risk Data Cleaning
github/awesome-copilot
Cleans raw credit data and screens variables before loan modeling, dropping unstable, noisy or redundant features and writing an Excel report of every step.
- Official
Daily Focus Board
github/awesome-copilot
Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.
- Official
Python Pypi Package Builder
github/awesome-copilot
End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.
Related
Works with
Categories
Questions about Python MCP Server Generator
What does Python MCP Server Generator do?
Generate a complete MCP server project in Python with tools, resources, and proper configuration. Python MCP Server Generator is an agent skill from github/awesome-copilot, published by the product's own GitHub organization.
When should I use Python MCP Server Generator?
Python MCP Server Generator fits situations like: tasks that involve MCP servers.
How do I install Python MCP Server Generator in Claude Code?
Run `npx skills add github/awesome-copilot --skill python-mcp-server-generator -a claude-code`. Or copy the skill folder (skills/python-mcp-server-generator in github/awesome-copilot) into .claude/skills/python-mcp-server-generator in your project. Claude Code loads it when a task matches its description.
How do I install Python MCP Server Generator in Codex?
Run `npx skills add github/awesome-copilot --skill python-mcp-server-generator -a codex`. Or copy the skill folder (skills/python-mcp-server-generator in github/awesome-copilot) into .agents/skills/python-mcp-server-generator in your project. Codex loads it when a task matches its description.
Can I use Python MCP Server Generator in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add github/awesome-copilot --skill python-mcp-server-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/python-mcp-server-generator, .gemini/skills/python-mcp-server-generator, .github/skills/python-mcp-server-generator and .opencode/skills/python-mcp-server-generator in your project.
What does Python MCP Server Generator need to run?
Going by SKILL.md and its folder, Python MCP Server Generator needs the command-line tools its instructions call (uv and python). Our summary lists: Python 3.
Does Python MCP Server Generator access the network?
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Python MCP Server Generator safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Python MCP Server Generator use?
Python MCP Server Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Python MCP Server Generator use?
About 990 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Python MCP Server Generator?
Skills that share tags, products or a category with Python MCP Server Generator: MCP Scaffold (timothywarner-org/claude-code, 224 stars), Open PR (ArcadeAI/arcade-mcp, 1k stars), Packet Tracer (Mats2208/MCP-Packet-Tracer, 241 stars) and MCP Developer (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Python MCP Server Generator?
github (a GitHub organization, an official publisher) maintains it in github/awesome-copilot, which has 39,748 GitHub stars. The repository holds 417 skills in this directory. The repository was last updated on October 7, 2026.
Source: github/awesome-copilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.