🚀 MCPCFC - ColdFusion MCP Server

Created By

revsmoke7 months ago

A Remote Model Context Protocol (MCP) server for ColdFusion, enabling CFML applications to connect with Claude and other AI assistants.

# coldfusion

# mcp

Overview Content Tools Comments

Content

🚀 MCPCFC - ColdFusion MCP Server

-Bring AI Superpowers to Your ColdFusion Applications

The world's first Model Context Protocol (MCP) server for ColdFusion!

Get Started → | View Demo | Documentation

🎉 NEW: Version 1.0.3 - All 8 tools working perfectly with Claude Desktop! See what's new →

🌟 What is MCPCFC?

MCPCFC enables ColdFusion applications to serve as tool providers for AI assistants like Claude, ChatGPT, and other LLMs through the standardized Model Context Protocol.

In simple terms: Your ColdFusion apps can now talk to AI, and AI can use your CF tools!

🎯 Perfect For

Government Agencies - Modernize legacy CF systems with AI capabilities
Enterprise Teams - Add AI features without replacing existing infrastructure
CF Developers - Build the next generation of intelligent applications
Digital Transformation - Bridge the gap between legacy and cutting-edge tech

⚡ Features at a Glance

🛠️ 8 Production-Ready Tools

✅ PDF Operations - Generate, extract text, and merge PDFs
✅ Email Automation - Send HTML/plain emails, validate addresses
✅ Database Queries - Natural language database interactions
✅ Extensible Design - Easy to add your own tools

🔧 Technical Excellence

✅ JSON-RPC 2.0 Protocol - Industry-standard communication
✅ Real-time SSE Support - Live updates and streaming
✅ Thread-Safe Design - Production-ready architecture
✅ Claude Desktop Ready - Works out of the box

🚀 Quick Start

Option 1: Browser Testing (5 minutes)

# Clone the repository
git clone https://github.com/revsmoke/mcpcfc.git

# Place in your ColdFusion webroot
# Navigate to http://localhost:8500/mcpcfc/
# Open the test client and start using AI tools!

Option 2: Claude Desktop Integration (10 minutes)

Install MCPCFC in your CF webroot
Make bridge executable: chmod +x cf-mcp-clean-bridge.sh

Add to Claude Desktop config:

{
"mcpServers": {
   "coldfusion-mcp": {
      "command": "/path/to/mcpcfc/cf-mcp-clean-bridge.sh"
   }
}
}

Restart Claude Desktop - Your CF tools are now available!

📚 Full Setup Guide →

🎬 See It In Action

Working Tools Demo

🤖 Claude: "Generate a PDF invoice for customer John Doe"
📄 MCPCFC: *Creates PDF with CF's built-in PDF tools*

🤖 Claude: "Email it to john@example.com"  
📧 MCPCFC: *Sends email with the PDF attached*

🤖 Claude: "Show me all customers from the database"
🗄️ MCPCFC: *Queries your CF datasource and returns results*

Live Example

// Your existing CF code
component {
    function generateReport(customerId) {
        // Your business logic here
    }
}

// Now accessible to AI assistants!
// Claude can call: "Generate a report for customer 123"

📊 Why MCPCFC?

Challenge	MCPCFC Solution
Legacy CF systems can't use modern AI	✅ Bridge CF to any AI assistant
Complex integration requirements	✅ Drop-in solution, minimal setup
Security concerns	✅ Built-in controls and query limits
Limited CF community tools	✅ Open source and extensible

🏗️ Architecture

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Claude    │────▶│    MCPCFC    │────▶│ Your CF App │
│  Desktop    │◀────│  MCP Server  │◀────│   & Tools   │
└─────────────┘     └──────────────┘     └─────────────┘
       ↓                    ↓                     ↓
   AI Assistant      JSON-RPC 2.0          PDF, Email,
                    + SSE Transport          Database

Directory Structure

/mcpcfc/
├── Application.cfc           # Application configuration
├── /components/             # Core MCP components
├── /endpoints/              # HTTP/SSE endpoints
├── /tools/                  # Tool implementations
├── /client-examples/        # Test clients
├── cf-mcp-clean-bridge.sh   # Claude Desktop bridge
└── README.md               # You are here!

🔧 Available Tools

Current Tools (v1.0.3)

Tool	Description	Status
hello	Simple greeting tool	✅ Working
queryDatabase	Execute SELECT queries	✅ Working
generatePDF	Create PDFs from HTML	✅ Working
extractPDFText	Extract text from PDFs	✅ Working
mergePDFs	Combine multiple PDFs	✅ Working
sendEmail	Send plain text emails	✅ Working
sendHTMLEmail	Send HTML emails	✅ Working
validateEmailAddress	Validate email format	✅ Working

Adding Custom Tools

// 1. Register in Application.cfc
application.toolRegistry.registerTool("myTool", {
    "description": "My custom tool",
    "inputSchema": {
        "type": "object",
        "properties": {
            "param1": {"type": "string"}
        }
    }
});

// 2. Implement in ToolHandler.cfc
case "myTool":
    return executeMyTool(arguments.args);