swiftpath-writing-tools-mcp

williamjvest/swiftpath-writing-tools-mcp

3.2

If you are the rightful owner of swiftpath-writing-tools-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

SwiftPath Writing Tools MCP Server is a specialized server providing writing analysis tools aligned with SwiftPath Logistics' brand voice, values, and communication standards.

Tools
5
Resources
0
Prompts
0

SwiftPath Writing Tools MCP Server

A specialized Model Context Protocol (MCP) server that provides writing analysis tools aligned with SwiftPath Logistics' brand voice, values, and communication standards.

Overview

This server extends the original writing-tools-mcp with SwiftPath-specific analysis capabilities, ensuring all communications align with the company's brand identity and core values.

Features

Core SwiftPath Tools

  • swiftpath_voice_analysis - Analyzes text for alignment with SwiftPath's brand voice attributes
  • values_alignment_check - Evaluates alignment with SwiftPath's five core values
  • tone_appropriateness - Assesses tone appropriateness for different communication contexts
  • swiftpath_score - Provides comprehensive SwiftPath alignment scoring
  • brand_voice_guide - Returns SwiftPath brand voice guidelines and examples
  • context_lookup - Searches SwiftPath's organizational playbook for specific information

Brand Voice Attributes

SwiftPath's voice is analyzed for these key attributes:

  • Straightforward - Plain language, avoids logistics jargon
  • Accountable - Owns commitments, communicates honestly
  • Energetic - Reflects urgency and dynamism of logistics
  • Collaborative - Positions as partner, not vendor

Core Values Analysis

Evaluates alignment with SwiftPath's core values:

  1. Reliability Through Ownership - We do what we say we'll do
  2. Speed with Safety - Urgency without compromising safety
  3. Creative Problem-Solving - Making the impossible possible
  4. Transparency in Communication - Open, honest communication
  5. Growth Mindset - People can develop new capabilities

Tone Contexts

Analyzes appropriateness for different contexts:

  • Marketing materials - Confident & inspiring
  • Customer communications - Professional & reassuring
  • Internal communications - Direct & motivating
  • Problem resolution - Honest & solution-focused
  • Social media - Personable & relatable

Installation

Prerequisites

  • Python 3.10 or higher
  • SwiftPath Logistics organizational playbook (automatically loaded from default location)

Setup

  1. Clone or download this repository

  2. Install dependencies using uv (recommended) or pip:

    uv sync
# or
pip install -e .

  3. Ensure the SwiftPath playbook is available at:

    /Users/williamvest/Library/Mobile Documents/iCloud~md~obsidian/Documents/vv/06-Context/03-EA-Agent/SwiftPath Logistics - Organizational Playbook.md

MCP Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "swiftpath-writing-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/swiftpath-writing-tools-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Usage Examples

Basic Voice Analysis

"Analyze this email for SwiftPath brand voice alignment: 'We will deliver your shipment on time and keep you informed throughout the process.'"

Values Alignment Check

"Check how well this customer communication aligns with SwiftPath values: 'We take full responsibility for the delay and have implemented additional safety protocols.'"

Tone Appropriateness

"Is this tone appropriate for a customer service email? 'We understand your concern and are actively working to resolve this issue for you.'"

Comprehensive Scoring

"Give me a comprehensive SwiftPath score for this marketing copy: 'SwiftPath turns your logistics challenges into competitive advantages through reliable, innovative delivery solutions.'"

Development

Project Structure

swiftpath-writing-tools-mcp/
├── app/
│   ├── analyzers/
│   │   ├── voice_analyzer.py      # Brand voice analysis
│   │   ├── values_analyzer.py     # Core values alignment
│   │   ├── tone_analyzer.py       # Tone appropriateness
│   │   └── swiftpath_analyzer.py  # Comprehensive analysis
│   ├── config/
│   │   └── settings.py            # Configuration settings
│   ├── context_loader.py          # Playbook context loading
│   └── __init__.py
├── server.py                      # Main MCP server
├── pyproject.toml                 # Project configuration
├── test_server.py                 # Structure testing
└── README.md                      # This file

Running Tests

python3 test_server.py

Dependencies

Key dependencies include:

  • mcp[cli] - MCP server framework
  • fastmcp - FastMCP 2.0 compatibility
  • spacy - Natural language processing
  • textstat - Text statistics
  • pyspellchecker - Spell checking
  • transformers - AI model integration (future)

FastMCP Cloud Deployment

This server is optimized for FastMCP Cloud deployment with automatic configuration.

Deployment Steps

  1. Push to GitHub:

    git push origin main

  2. Deploy on FastMCP Cloud:

    • Visit FastMCP Cloud
    • Connect your GitHub repository: williamjvest/swiftpath-writing-tools-mcp
    • Set entrypoint: server.py:mcp
    • Deploy!

Environment Variables (Optional)

To provide a custom playbook location:

  • SWIFTPATH_PLAYBOOK_PATH - Full path to your organizational playbook file

If not set, the server will use the built-in fallback context with SwiftPath's core values and brand voice.

Cloud Features

  • Automatic dependency installation from pyproject.toml
  • Graceful fallback when playbook file is not available
  • Production-ready error handling
  • Minimal memory footprint with lazy loading

Configuration

Settings

The server can be configured through environment variables or by modifying app/config/settings.py:

  • PLAYBOOK_PATH - Path to SwiftPath organizational playbook
  • MIN_TEXT_LENGTH - Minimum text length for analysis (default: 10)
  • MAX_TEXT_LENGTH - Maximum text length for analysis (default: 50000)
  • SCORING_THRESHOLDS - Quality thresholds for analysis

Context Loading

The server automatically loads SwiftPath context from the organizational playbook. If the playbook is not found, it falls back to a minimal context that provides basic functionality.

Scoring System

Quality Levels

  • Excellent (85-100): Meets all SwiftPath standards
  • Good (70-84): Acceptable with minor improvements needed
  • Needs Improvement (50-69): Significant revisions required
  • Poor (0-49): Does not meet SwiftPath standards

Component Weights

  • Values Alignment: 40% - Most important component
  • Voice Alignment: 35% - Brand consistency
  • Tone Appropriateness: 25% - Context fit

Contributing

  1. Follow SwiftPath brand guidelines in all contributions
  2. Ensure all code passes the structure test (python3 test_server.py)
  3. Update documentation for new features
  4. Test with real SwiftPath communications

License

MIT License - see LICENSE file for details

Support

For technical support or questions about this MCP server, contact the SwiftPath Technology team.

SwiftPath Logistics - Delivering what matters, when it matters, by empowering our people to solve problems at the point of action.