What is Mcpcfc

MCPCFC is a Remote Model Context Protocol (MCP) server designed for ColdFusion applications, allowing them to connect with AI assistants like Claude and ChatGPT through a standardized protocol.

Use cases

Use cases for MCPCFC include automating document generation and processing, enhancing customer communication through email automation, and enabling natural language interactions with databases for improved data accessibility.

How to use

To use MCPCFC, ColdFusion developers can integrate it into their applications by following the quick start guide provided in the documentation. This involves setting up the server and utilizing the available tools for AI interactions.

Key features

MCPCFC offers 8 production-ready tools including PDF operations, email automation, and natural language database queries, enabling seamless integration of AI capabilities into ColdFusion applications.

Where to use

MCPCFC is ideal for government agencies looking to modernize legacy systems, enterprise teams wanting to enhance existing infrastructure with AI, CF developers aiming to create intelligent applications, and organizations undergoing digital transformation.

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

1. Install MCPCFC in your CF webroot

2. Make bridge executable: chmod +x cf-mcp-clean-bridge.sh

3. Add to Claude Desktop config:

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

4. 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 [email protected]"  
📧 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?

🏗️ 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)

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

🛡️ Security & Configuration

Database Security

• Only SELECT queries allowed by default
• Parameterized queries prevent SQL injection
• Configure datasources in your tool implementations

Recommended Settings

• Add authentication layer
• Implement rate limiting
• Use environment variables for sensitive data
• Enable audit logging

🤝 Contributing

We need your help to make MCPCFC even better!

How to Contribute

1. Star the repo - Help others discover MCPCFC
2. Report issues - Found a bug? Let us know!
3. Submit PRs - Add features or fix issues
4. Share your use cases - Tell us how you’re using it
5. Write documentation - Help others get started

Contributing Guide →

Roadmap

• [ ] Authentication providers (OAuth, SAML)
• [ ] More tool templates (Excel, FTP, SOAP)
• [ ] WebSocket transport option
• [ ] Docker container support
• [ ] Tool marketplace

📚 Resources

• Quick Start Guide - Get running in minutes
• API Documentation - Detailed API reference
• Troubleshooting - Common issues and solutions
• Examples - Sample implementations

Community

• GitHub Discussions - Ask questions, share ideas
• Issues - Report bugs or request features
• Email: [email protected]

🙏 Acknowledgments

• Anthropic - For creating the Model Context Protocol
• The ColdFusion Community - For keeping CF alive and thriving
• Early Adopters - For testing and providing feedback
• You - For being part of this journey!

📄 License

MCPCFC is open source software licensed under the MIT License.

🚀 Ready to Get Started?

Download MCPCFC | View on GitHub | Read the Docs

Show Your Support

If MCPCFC helps your project, please consider:

• ⭐ Starring the repository
• 📢 Sharing with your network
• 🤝 Contributing to the project

CFLOVE

-Made with ❤️ for the ColdFusion community

🌐 mcpcfc.dev | 📧 [email protected]