fastmcp-skill

Claude Code skill for building MCP servers with FastMCP v3 (Prefect).

What is this?

A Claude Code custom skill that gives Claude expert knowledge about FastMCP v3 — the standard Python framework for building Model Context Protocol servers.

When triggered, Claude gains access to the full FastMCP v3 documentation (331 files, 2.8MB) and curated reference guides, enabling it to write correct MCP server code without hallucinating APIs.

What it covers

• Tools, Resources, Prompts (@mcp.tool, @mcp.resource, @mcp.prompt)
• Context, Dependency Injection, Middleware
• Server Composition (mount, ProxyProvider, SkillsProvider)
• Testing (in-memory Client, HTTP transport)
• Deployment (stdio, HTTP, ASGI, FastAPI)
• Authentication (OAuth, token verification)
• CLI (fastmcp run, fastmcp inspect, fastmcp install)
• Integrations (Claude Desktop, Cursor, OpenAI, etc.)
• Full Python SDK reference

Installation

Option 1: Clone into your project's .claude/skills/

git clone https://github.com/jxnxts/fastmcp-skill.git .claude/skills/fastmcp

Then add to your project's .claude/settings.json:

{
  "skills": {
    "fastmcp": {
      "path": ".claude/skills/fastmcp"
    }
  }
}

Option 2: Global installation

git clone https://github.com/jxnxts/fastmcp-skill.git ~/.claude/skills/fastmcp

Then add to your global ~/.claude/settings.json:

{
  "skills": {
    "fastmcp": {
      "path": "~/.claude/skills/fastmcp"
    }
  }
}

Usage

Claude Code automatically triggers this skill when you mention:

• "FastMCP", "MCP server", "Model Context Protocol"
• @mcp.tool, @mcp.resource, @mcp.prompt
• "add a tool", "create an MCP endpoint"
• Any MCP server creation, modification, or debugging task

You can also invoke it explicitly:

/fastmcp

Structure

fastmcp-skill/
├── SKILL.md              # Skill definition + quick reference
├── references/           # Curated topic guides
│   ├── tools.md
│   ├── resources-prompts.md
│   ├── context-di-middleware.md
│   ├── composition-providers.md
│   ├── testing.md
│   └── deployment.md
└── docs/                 # Full FastMCP v3 documentation (331 files)
    ├── python-sdk/       # Complete Python SDK reference
    ├── servers/          # Server components docs
    ├── clients/          # Client usage docs
    ├── integrations/     # IDE & platform integrations
    ├── cli/              # CLI commands
    ├── deployment/       # Deployment guides
    └── ...

License

MIT