mcpcfc

Name: mcpcfc
Availability: InStock
Author: Reverend Smoke

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

GitHub

GitHub Stars

User Rating

Not Rated

Forks

Issues

Views

Favorites

README

🚀 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);