Reza FastMCP Server

A comprehensive FastMCP-based Model Context Protocol (MCP) server providing 38+ text manipulation, web scraping, YouTube transcripts, and utility tools.

Installation

Prerequisites

We recommend using uv to manage Python environments and dependencies.

Install Dependencies

Install all required dependencies:

# Using uv (recommended)
uv pip install -r requirements.txt

# Or using pip
pip install -r requirements.txt

This will install:

• FastMCP (core framework)
• youtube-transcript-api (YouTube transcripts)
• requests & beautifulsoup4 (web scraping)
• validators (URL/email validation)
• markdown (format conversion)
• python-dateutil & pytz (timezone handling)
• And more...

Verify Installation

Verify FastMCP is installed correctly:

fastmcp version

You should see output like:

FastMCP version:                           2.11.3
MCP version:                               1.12.4
Python version:                            3.12.2

Setup

1. Install dependencies:

   cd ~/mcp-servers/reza-fastmcp
   uv pip install fastmcp
   

2. Make the server executable:

   chmod +x server.py
   

3. Test the server:

   python server.py
   

Available Features

Tools (38 Available)

Basic Text Operations

• echo_tool: Echo the input text
• reverse_text: Reverse the input text
• word_count: Count words and characters in text
• uppercase: Convert text to uppercase
• lowercase: Convert text to lowercase
• title_case: Convert text to title case
• capitalize_first: Capitalize only the first letter
• split_text: Split text by a delimiter
• join_text: Join text parts with a delimiter

Text Cleaning & Formatting

• remove_whitespace: Remove all whitespace from text
• normalize_whitespace: Normalize whitespace (replace multiple spaces with single space)
• find_and_replace: Find and replace text with case sensitivity options
• sort_lines: Sort lines in text with reverse and case options
• remove_duplicates: Remove duplicate lines preserving or ignoring order

Data Extraction

• extract_emails: Extract email addresses from text
• extract_urls: Extract URLs from text
• extract_phone_numbers: Extract phone numbers from text
• slug_from_text: Create URL-friendly slugs from text

Encoding & Security

• encode_base64: Encode text to base64
• decode_base64: Decode base64 text
• hash_text: Generate hash using MD5, SHA1, SHA256, or SHA512
• generate_uuid: Generate random UUID
• generate_password: Generate secure random passwords

JSON Operations

• format_json: Format JSON with proper indentation
• minify_json: Minify JSON (remove whitespace)

Analytics & Statistics

• text_statistics: Get comprehensive text analytics (words, sentences, reading time, etc.)
• word_frequency: Get word frequency analysis with top N results

Utilities

• current_timestamp: Get current timestamp in various formats

YouTube Tools (NEW)

• youtube_transcript: Get YouTube video transcript in plain text
• youtube_transcript_with_timestamps: Get transcript with timestamps

Web Scraping Tools (NEW)

• fetch_webpage: Fetch and parse webpage content with metadata
• extract_links: Extract all links from a webpage

Validation Tools (NEW)

• validate_email: Validate email address format
• validate_url: Validate URL format

Format Conversion Tools (NEW)

• markdown_to_html: Convert Markdown to HTML
• html_to_text: Convert HTML to plain text

Date/Time Tools (NEW)

• parse_date: Parse date strings to various formats
• timezone_convert: Convert time between timezones

Resources

• reza://info: Server information and capabilities
• reza://stats: Server statistics and metrics
• reza://text/{operation}: Information about specific text operations

Prompts

• analyze_text: Generate prompts for text analysis
• transform_text: Generate prompts for text transformation
• creative_writing: Generate creative writing prompts

Configuration for Claude Desktop

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "reza-fastmcp": {
      "command": "python",
      "args": ["~/mcp-servers/reza-fastmcp/server.py"]
    }
  }
}

Upgrading from Official MCP SDK

If you're upgrading from the official MCP SDK's FastMCP 1.0 to FastMCP 2.0:

# Before (MCP SDK 1.0)
# from mcp.server.fastmcp import FastMCP

# After (FastMCP 2.0+)
from fastmcp import FastMCP

Development

To add new tools, edit server.py and add decorated functions:

@mcp.tool()
def your_tool(param: str) -> str:
    """Your tool description"""
    return process(param)

Versioning

For production use, always pin to exact versions:

fastmcp==2.11.0  # Good
fastmcp>=2.11.0  # Bad - may install breaking changes

Deployment

Local Development

Follow the setup instructions above for local development and testing.

FastMCP Cloud Deployment

For production deployment, you can use FastMCP Cloud:

1. Create a FastMCP Cloud account
2. Connect your GitHub account
3. Select this repository for deployment
4. Your MCP server will be automatically deployed and scaled
5. Server will be available at: https://reza-fastmcp.fastmcp.app/mcp

Manual Deployment

For custom deployment scenarios, ensure:

• Python 3.8+ environment
• FastMCP dependencies installed
• Server accessible on the required port
• Proper firewall and security configurations

Contributing

See the FastMCP Contributing Guide for details on:

• Setting up development environment
• Running tests and pre-commit hooks
• Submitting issues and pull requests
• Code standards and review process

Learn More

• FastMCP Documentation
• MCP Protocol Specification
• FastMCP Cloud