🚀 MCPCFC - ColdFusion MCP 服务器

-为您的 ColdFusion 应用程序带来 AI 超能力

世界上第一个针对 ColdFusion 的模型上下文协议（MCP）服务器！

开始使用 → | 查看演示 | 文档

---

🎉 新版本：1.0.3 - 所有8个工具与 Claude Desktop 完美兼容！查看更新内容 →

---

🌟 MCPCFC 是什么？

MCPCFC 允许 ColdFusion 应用程序作为 AI 助手（如 Claude、ChatGPT 和其他大型语言模型）的工具提供者，通过标准化的模型上下文协议进行通信。

简单来说：您的 ColdFusion 应用程序现在可以与 AI 对话，AI 也可以使用您的 CF 工具！

🎯 适用于

• 政府机构 - 通过 AI 功能现代化旧版 CF 系统
• 企业团队 - 在不替换现有基础设施的情况下添加 AI 功能
• CF 开发者 - 构建下一代智能应用程序
• 数字化转型 - 桥接传统技术和前沿技术之间的差距

---

⚡ 特性一览

🛠️ 8 个生产就绪工具

✅ PDF 操作 - 生成、提取文本和合并 PDF 文件
✅ 电子邮件自动化 - 发送 HTML/纯文本邮件，验证地址
✅ 数据库查询 - 自然语言数据库交互
✅ 可扩展设计 - 易于添加您自己的工具

🔧 技术卓越

✅ JSON-RPC 2.0 协议 - 行业标准通信
✅ 实时 SSE 支持 - 实时更新和流传输
✅ 线程安全 设计 - 生产就绪架构
✅ Claude Desktop 就绪 - 开箱即用

---

🚀 快速开始

选项 1：浏览器测试（5 分钟）

# 克隆仓库
git clone https://github.com/revsmoke/mcpcfc.git

# 放入您的 ColdFusion webroot
# 导航到 http://localhost:8500/mcpcfc/
# 打开测试客户端并开始使用 AI 工具！

选项 2：Claude Desktop 集成（10 分钟）

1. 在您的 CF webroot 中安装 MCPCFC

2. 使桥接可执行：chmod +x cf-mcp-clean-bridge.sh

3. 添加到 Claude Desktop 配置：

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

4. 重启 Claude Desktop - 您的 CF 工具现在可用！

📚 完整设置指南 →

---

🎬 实际操作演示

工作工具演示

🤖 Claude: "为顾客 John Doe 生成一张发票 PDF"
📄 MCPCFC: *使用 CF 内置 PDF 工具创建 PDF*

🤖 Claude: "将其发送给 john@example.com"  
📧 MCPCFC: *附带 PDF 发送邮件*

🤖 Claude: "显示数据库中的所有客户"
🗄️ MCPCFC: *查询您的 CF 数据源并返回结果*

实时示例

// 您现有的 CF 代码
component {
    function generateReport(customerId) {
        // 您的业务逻辑在这里
    }
}

// 现在可以被 AI 助手访问！
// Claude 可以调用："为顾客 123 生成报告"

---

📊 为什么选择 MCPCFC？

挑战	MCPCFC 解决方案
旧版 CF 系统无法使用现代 AI	✅ 将 CF 桥接到任何 AI 助手
复杂的集成需求	✅ 即插即用解决方案，最小化设置
安全顾虑	✅ 内置控制和查询限制
有限的 CF 社区工具	✅ 开源且可扩展

---

🏗️ 架构

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Claude    │────▶│    MCPCFC    │────▶│ Your CF App │
│  Desktop    │◀────│  MCP Server  │◀────│   & Tools   │
└─────────────┘     └──────────────┘     └─────────────┘
       ↓                    ↓                     ↓
   AI 助手      JSON-RPC 2.0          PDF, Email,
                    + SSE 传输          数据库

目录结构

/mcpcfc/
├── Application.cfc           # 应用程序配置
├── /components/             # 核心 MCP 组件
├── /endpoints/              # HTTP/SSE 端点
├── /tools/                  # 工具实现
├── /client-examples/        # 测试客户端
├── cf-mcp-clean-bridge.sh   # Claude Desktop 桥接
└── README.md               # 欢迎光临！

---

🔧 可用工具

当前工具（v1.0.3）

工具	描述	状态
hello	简单问候工具	✅ 运行中
queryDatabase	执行 SELECT 查询	✅ 运行中
generatePDF	从 HTML 创建 PDF	✅ 运行中
extractPDFText	从 PDF 提取文本	✅ 运行中
mergePDFs	合并多个 PDF	✅ 运行中
sendEmail	发送纯文本邮件	✅ 运行中
sendHTMLEmail	发送 HTML 邮件	✅ 运行中
validateEmailAddress	验证邮箱格式	✅ 运行中

添加自定义工具

// 1. 在 Application.cfc 中注册
application.toolRegistry.registerTool("myTool", {
    "description": "我的自定义工具",
    "inputSchema": {
        "type": "object",
        "properties": {
            "param1": {"type": "string"}
        }
    }
});

// 2. 在 ToolHandler.cfc 中实现
case "myTool":
    return executeMyTool(arguments.args);

---

🛡️ 安全与配置

数据库安全

• 默认只允许 SELECT 查询
• 参数化查询防止 SQL 注入
• 在您的工具实现中配置数据源

推荐设置

• 添加身份验证层
• 实现速率限制
• 使用环境变量存储敏感数据
• 启用审计日志

---

🤝 贡献

我们需要您的帮助来让 MCPCFC 更好！

如何贡献

1. 点赞仓库 - 帮助其他人发现 MCPCFC
2. 报告问题 - 发现了错误？告诉我们！
3. 提交 PR - 添加功能或修复问题
4. 分享您的使用案例 - 告诉我们您是如何使用的
5. 编写文档 - 帮助他人入门

贡献指南 →

路线图

• 身份验证提供者（OAuth，SAML）
• 更多工具模板（Excel，FTP，SOAP）
• WebSocket 传输选项
• Docker 容器支持
• 工具市场

---

📚 资源

• 快速入门指南 - 几分钟内启动
• API 文档 - 详细的 API 参考
• 故障排除 - 常见问题及解决方法
• 示例 - 示例实现

社区

• GitHub 讨论 - 提问，分享想法
• 问题 - 报告错误或请求功能
• 电子邮件：hello@mcpcfc.dev

---

🙏 致谢

• Anthropic - 创造了模型上下文协议
• ColdFusion 社区 - 保持 CF 生机勃勃
• 早期采用者 - 测试并提供反馈
• 您 - 成为此旅程的一部分！

---

📄 许可

MCPCFC 是根据 MIT 许可 开源的软件。

---

🚀 准备开始了吗？

下载 MCPCFC | 在 GitHub 上查看 | 阅读文档

展示您的支持

如果 MCPCFC 对您的项目有所帮助，请考虑：

• ⭐ 点赞仓库
• 📢 与您的网络分享
• 🤝 贡献于项目

---

CFLOVE

-由 ❤️ 为 ColdFusion 社区打造

🌐 mcpcfc.dev | 📧 hello@mcpcfc.dev