husniadil-fastmcp-builder

FastMCP Builder - Claude Code Skill

A comprehensive Claude Code skill for building production-ready MCP (Model Context Protocol) servers using the FastMCP Python framework. This skill provides complete reference implementations, working examples, and proven patterns for creating robust MCP servers with tools, resources, prompts, OAuth authentication, and comprehensive testing.

What is FastMCP?

FastMCP is the official high-level Python framework for building MCP servers. It's simpler, faster to develop with, and more maintainable than the low-level MCP SDK. This skill focuses exclusively on FastMCP-based development.

What's Included

This skill contains everything you need to build production-ready FastMCP servers:

1. Reference Documentation (reference/)

Six comprehensive guides covering all aspects of FastMCP development:

• fastmcp_overview.md - Introduction, when to use FastMCP, key features
• project_structure.md - Recommended structure, file organization, DRY patterns
• tool_patterns.md - 6 tool patterns with complete examples
• resource_patterns.md - 4 resource types (static, dynamic, template, wildcard)
• oauth_integration.md - Complete Google OAuth setup guide
• testing_guide.md - FastMCP Client testing, patterns, best practices

2. Code Examples (examples/)

Runnable examples from minimal to complete servers:

• minimal_server.py - Absolute simplest FastMCP server (28 lines)
• complete_server_structure.py - Full-featured single-file example with all patterns
• test_examples.py - Comprehensive testing examples

3. Complete Reference Project (reference-project/)

A full production implementation demonstrating best practices:

• 6 production-ready tools - Various patterns (sync, async, stateful, with context)
• 7 resource instances - 4 types (static, dynamic, template, wildcard)
• 1 universal prompt - Reusable prompt template
• 145 passing tests - Comprehensive test coverage
• OAuth integration - Complete Google OAuth setup
• Dual-mode architecture - main.py (with OAuth) + main_noauth.py (local testing)
• DRY principle - Uses common.py for component registration

When to Use This Skill

Use this skill when you need to:

• Build MCP servers with FastMCP (Python-based development)
• Add OAuth authentication (especially Google OAuth for remote access)
• Implement production patterns (tools, resources, prompts with best practices)
• Set up comprehensive testing (using FastMCP Client for fast, in-memory tests)
• Structure larger projects (proper organization and separation of concerns)
• Deploy to production (with authentication, error handling, monitoring)

Don't use this skill for:

• TypeScript/Node.js MCP servers (use mcp-builder skill instead)
• Low-level MCP protocol work (use MCP SDK directly)
• Non-FastMCP Python servers (this is FastMCP-specific)

Installation

Option 1: Install via Plugin Marketplace (Recommended)

1. Register this marketplace in Claude Code:

   /plugin marketplace add husniadil/fastmcp-builder
   

2. Browse and install:

   • Select "Browse and install plugins"
   • Choose "fastmcp-builder-skill"
   • Select "fastmcp-builder"
   • Click "Install now"

3. Or install directly:

   /plugin install fastmcp-builder@fastmcp-builder-skill
   

Option 2: Manual Installation

Clone or download this repository to your Claude Code skills directory:

cd ~/.claude/skills
git clone https://github.com/husniadil/fastmcp-builder.git

Using the Skill

Once installed, simply reference the skill in your request:

Use the fastmcp-builder skill to create a new MCP server with OAuth authentication

Quick Start

Simple Example

Create a minimal FastMCP server:

from fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def greet(name: str) -> str:
    """Greet someone by name"""
    return f"Hello, {name}!"

if __name__ == "__main__":
    mcp.run()

Try the Included Examples

Navigate to the skill directory and run the examples:

# Navigate to skill directory
cd ~/.claude/plugins/marketplaces/fastmcp-builder-skill

# Try the minimal server
python examples/minimal_server.py

# Try the complete server structure
python examples/complete_server_structure.py

# Run with HTTP mode
python examples/complete_server_structure.py --http

Building Your First Server

Phase 1: Planning & Setup