fastmcp-builder

FastMCP Builder is a Python-based MCP server scaffold that helps you build production-ready MCP servers using the FastMCP framework. It provides reference implementations, runnable examples, and established patterns for tools, resources, prompts, OAuth authentication, and testing. The skill emphasizes a DRY, modular structure with clearly separated components (tools, resources, prompts) and offers a dual-entry server setup (with and without OAuth) to support both production deployment and local testing. You can use the included examples and reference guides to rapidly spin up a server, implement new tools and resources, and integrate Google OAuth for remote access.

Core capabilities include: (1) reusable tool patterns (basic sync tools, data processing, context-aware tools, Stateful and async patterns, API integrations), (2) multiple resource types (static, dynamic, template, wildcard), and (3) a complete testing strategy using the FastMCP client for in-memory and integration tests. The workflow emphasizes planning with the reference docs, implementing configuration, registering components in a DRY fashion, and validating via tests before deployment. It also demonstrates how to structure a project for production, including authentication, error handling, and monitoring considerations.

Prerequisites:

• Python 3.9+ (preferably 3.10+)
• Access to installation tooling (uv) or pipx for Python package management
• Internet access to fetch dependencies

Option A: Install via Plugin Marketplace (Recommended for Claude Code users)

1. Install marketplace entry for fastmcp-builder:

   /plugin marketplace add husniadil/fastmcp-builder

2. Browse and install:

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

3. Or install directly via command:

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

Option B: Manual Installation

1. Clone the repository into your Claude Code skills directory:

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

2. Install Python dependencies (example using uv):

   uv add fastmcp==2.13.0.1 python-dotenv==1.2.1 uv add --optional test pytest==8.4.2 pytest-asyncio==1.2.0 pytest-mock==3.15.1 httpx==0.28.1

3. Use the skill by referencing it in your request, for example:

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

Tips and common issues:

• The project emphasizes Google OAuth integration for remote access; ensure you follow the reference/oauth_integration.md doc when enabling OAuth in production.
• Use the dual-entry point approach: main.py for OAuth-enabled deployment and main_noauth.py for local testing.
• The recommended project structure encourages DRY component registration via a shared common.py module.
• For testing, rely on the provided references and tests scaffolding (tests/conftest.py, test_tools.py, test_resources.py, test_integration.py) and run via uv run pytest tests/ -v.
• Environment variables should be documented in a .env.example file and greenlit before deployment.
• If you’re migrating from a Node.js MCP server, this FastMCP-based approach is Python-centric and leverages uv/uvx tooling instead of npm.