python-mcp-server-generator Skill for Claude: What It Does and How to Install It

Makes Claude build a Python MCP server with the official SDK v2: a uv project, typed tools, tests and client config.

Installs: 10.4K; on skills.sh
Stars: 40.7K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill walks Claude through five steps: create a uv project, write the server, write the tests, run the tests until they pass, and configure the client. It uses the MCP Python SDK v2 with MCPServer, and it covers VS Code and Claude Desktop.

Its compatibility line says it needs uv, Python 3.10 or later and network access to install packages. A list of 14 gotchas lists SDK v1 patterns that no longer work, such as FastMCP and print() on a stdio server. A second guide covers serving over Streamable HTTP.

Good for

Python developers who want to expose functions as MCP tools
Teams giving AI clients access to an API or database
Builders who want pytest tests for every tool
VS Code and Claude Desktop users wiring up a local server

Install python-mcp-server-generator

Claude Code

Copy this prompt.

Install the python-mcp-server-generator skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill python-mcp-server-generator

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Pick one route. The skill's compatibility line says it needs uv, Python 3.10 or later and network access to install packages, and the MCP Inspector needs Node.js. The awesome-copilot repo also has a GitHub Copilot CLI plugin, python-mcp-development, that holds this skill plus a python-mcp-expert agent; its README gives the Copilot CLI install command. The skills routes install only the skill.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Use this skill when the user wants to create a new Model Context Protocol (MCP) server in Python. Also use it to expose Python functions, an API, or a database to AI clients as MCP tools. The skill makes a uv project with the MCP Python SDK v2 (MCPServer), typed tools, in-memory tests, and client configuration. Do not use it for an MCP client or for a server in another language.

Sections in SKILL.md

Workflow
Step 1: Create the project
Step 2: Write the server
Step 3: Write the tests
Step 4: Run the tests until they pass
Step 5: Configure the client
Gotchas

Key facts

Author: github/awesome-copilot (repo owner; third-party contributors per the README)
License: MIT
Installs on skills.sh: 10,449 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What it includes: 2 files including SKILL.md: references/streamable-http.md. No scripts
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass (Nov 2, 2026)
Needs: uv, Python 3.10 or later and network access to install packages; Node.js for the MCP Inspector (SKILL.md compatibility line)

What it includes

uv init --app --no-package, then uv add mcp[cli] (version 2) and pytest
Also tells Claude to delete the generated main.py.
Runs code · Step 1: Create the project
A server.py template with MCPServer, typed tools, docstrings and ToolError
Write · Step 2: Write the server
test_server.py using the in-memory Client, one test per tool and error
Write · Step 3: Write the tests
uv run pytest, fix, and repeat until all tests pass
Runs code · Step 4: Run the tests
.vscode/mcp.json for VS Code, uv run mcp install server.py for Claude Desktop
Runs code · Step 5: Configure the client
14 SDK v2 rules, such as no FastMCP, no print() on stdio and ToolError for tool errors
Gotchas
Run as a remote server, mount in an ASGI app, host and origin checks, CORS
Only for remote or HTTP servers.
Write · Streamable HTTP guide

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

HTTP mode skips host checks on public hosts
streamable-http.md says the SDK checks Host and Origin only for localhost hosts unless you set transport_security. Set it before you bind to 0.0.0.0 or a public name. github.com
It installs packages from the network
Step 1 runs uv add "mcp[cli]>=2,<3" and uv add --dev pytest. Run it in the project you mean to change. github.com
It edits your client configuration
Step 5 writes .vscode/mcp.json or runs uv run mcp install server.py for Claude Desktop. Check the server path it registers. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. SKILL.md shows a read_only_hint annotation for tools the server exposes.
Talks to	Package downloads for uv add. A local or remote port, if you run the HTTP transport
Sign-in and keys	SKILL.md does not mention any account or key. The HTTP guide reads optional HOST and PORT environment variables.
Scopes	Claude can run uv init, uv add and uv run pytest in your project Claude deletes the main.py that uv init creates Claude writes .vscode/mcp.json, or runs uv run mcp install server.py to configure Claude Desktop The Copilot CLI plugin route also adds the python-mcp-expert agent, whose front matter lists a name and description and no tools

Questions

How do I install python-mcp-server-generator?

Use the install box at the top of this page. It shows a skills CLI command for this skill and folder copies for Claude Code and Codex. The awesome-copilot repo also has a GitHub Copilot CLI plugin, python-mcp-development, that holds this skill and a python-mcp-expert agent.

What does the python-mcp-server-generator skill do?

It makes Claude create a working Python MCP server project. Claude sets up uv, writes a typed server, writes tests, runs them until they pass and writes the client config.

What do I need installed?

uv, Python 3.10 or later, and network access to install packages. The MCP Inspector also needs Node.js. These are from the skill's compatibility line.

Does it make an MCP client?

SKILL.md says not to use it for an MCP client or for a server in another language.

Why does it warn about SDK v1 examples?

SKILL.md says SDK v2 removed FastMCP, so old v1 examples will fail. It tells Claude to import MCPServer from mcp.server and to avoid features the 2026-07-28 revision deprecates.

Can it run a remote server?

Yes, through a second guide. By default it uses stdio, and Claude reads references/streamable-http.md only when you ask for a remote or HTTP server.

Is it safe?

The skill bundles no scripts, but Claude runs uv commands that install packages and writes files in your project. Read the awesome-copilot README's warning: "The customizations here are sourced from third-party developers. Please inspect any agent and its documentation before installing."

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/python-mcp-server-generator

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

python-mcp-server-generator SKILL.md · github.com
streamable-http.md · github.com
awesome-copilot README · github.com
python-mcp-development plugin.json · github.com
python-mcp-development README · github.com
python-mcp-expert agent · github.com