Chameleoon MCP Server

“Chameleoon” MCP Server的功能是什么?

Chameleoon MCP Server通过Model Context Protocol (MCP)在Chameleoon的运输管理平台和AI助手之间提供无缝集成。它使电子商务企业、物流团队和履行操作能够使用自然语言命令自动化运输工作流程。该服务器连接到Chameleoon的多快递公司平台，允许AI助手创建运输订单、跨多个承运商跟踪交货、生成各种格式的运输标签、安排快递取件，并管理整个运输生命周期，无需手动仪表板导航。这将复杂的物流操作转变为简单的对话命令，大大减少了重复运输任务所花费的时间。

提示列表

订单创建和管理

为John Smith在Main Street 123, Prague 10000, Czech Republic使用GLS快递创建运输订单

显示过去7天创建的所有运输订单

查找DPD快递中所有状态为'waiting'的订单

删除ID为12345的运输订单

获取订单ID 67890的详细信息，包括跟踪历史

包裹跟踪和监控

跟踪运输编号06515700194651的包裹

显示本月运往德国的所有订单的当前状态和位置

查找参考号ORDER-2026-001的跟踪信息

哪些包裹目前在运输中，预计何时到达?

显示过去14天所有已交付订单及其交付日期

运输标签生成

为订单123、456和789生成A4运输标签

为今天准备取件的所有订单创建A6格式的热敏标签

获取Zebra打印机的ZPL格式标签，运输编号: [列表]

为昨天创建的所有GLS订单生成A4格式标签

快递和服务选择

列出所有可用的快递公司及其功能，如取件支持和清单打印

显示可用于运送到斯洛伐克的快递配置

DPD快递有哪些可用配置文件?

取件安排和管理

显示今天符合快递取件条件的所有订单

为DPD安排取件，运输编号: [列表]

列出过去3天按快递公司分组的所有取件订单

验证和质量控制

在创建此运输订单之前进行验证：收件人姓名、地址、重量和快递设置

检查此地址对于GLS交付到奥地利是否有效

验证所有等待发货的订单，并显示任何有错误或警告的订单

准备好发展您的业务了吗？

今天开始免费试用，几天内即可看到结果。

申请演示 登录

资源列表

Chameleoon MCP Server不公开显式资源。所有数据访问都基于工具。

工具列表

Chameleoon MCP Server提供14个综合工具，分为五个类别：

快递管理工具

1. list_couriers

• 目的: 检索可用的运输快递公司/承运商及其功能
• 参数: 无
• 返回: 快递公司列表，包括ID、名称、功能（取件支持、清单打印）
• 用例: 在创建订单之前确定哪些快递公司可用

2. list_courier_configurations

• 目的: 获取用于创建运输订单的快递配置文件/配置
• 参数: 无
• 返回: 可用的快递配置，包括配置文件ID和设置
• 用例: 查找订单创建所需的有效配置文件值

运输订单工具

3. list_shipping_orders

• 目的: 列出和筛选运输订单
• 参数:
  • date_from (可选): 开始日期 (YYYY-MM-DD)
  • date_to (可选): 结束日期 (YYYY-MM-DD)
  • reference (可选): 按参考号筛选
  • status (可选): 按订单状态筛选
  • state (可选): 按订单状态筛选
  • courier_id (可选): 按快递筛选
  • limit (可选): 最大结果数 (1-100)
  • offset (可选): 分页偏移量
• 返回: 带有跟踪URL的订单、计数和应用的筛选器
• 用例: 监控订单、查找特定货物、生成报告

4. get_shipping_order

• 目的: 通过内部ID获取特定订单的详细信息
• 参数:
  • order_id (必需): 内部订单标识符
• 返回: 完整的订单详细信息，包括跟踪历史
• 用例: 深入了解特定订单状态和历史

5. get_order_tracking

• 目的: 通过快递运输/跟踪号跟踪包裹
• 参数:
  • shipping_number (必需): 快递跟踪号
• 返回: 订单详细信息、跟踪历史、当前状态、收件人信息、跟踪URL
• 用例: 客户服务、交付状态更新

6. create_shipping_order

• 目的: 使用特定快递和配置文件创建新运输订单
• 参数:
  • courier_id (必需): 快递标识符 (例如 ‘gls’, ‘dpd’, ‘packeta’)
  • profile (必需): 来自快递配置的配置文件ID
  • reference_number (必需): 您的订单参考
  • recipient_name (必需): 收件人全名
  • recipient_street (必需): 街道地址
  • recipient_city (必需): 城市
  • recipient_zip (必需): 邮政编码
  • recipient_country (必需): ISO国家代码 (例如 ‘SK’, ‘CZ’)
  • recipient_company (可选): 公司名称
  • recipient_phone (可选): 电话号码
  • recipient_email (可选): 电子邮件地址
  • package_weight (可选): 重量（千克）
  • package_width (可选): 宽度（厘米）
  • package_height (可选): 高度（厘米）
  • package_length (可选): 长度（厘米）
  • cod_amount (可选): 货到付款金额
  • cod_currency (可选): COD货币 (例如 ‘EUR’)
  • note (可选): 给快递的备注
• 返回: 成功确认、运输编号、标签URL
• 用例: 自动化订单履行、批量运输

7. delete_shipping_order

• 目的: 删除单个运输订单
• 参数:
  • order_id (必需): 要删除的订单ID
• 返回: 成功确认
• 用例: 取消错误订单、清理测试订单

8. delete_shipping_orders_batch

• 目的: 一次删除多个订单
• 参数:
  • order_ids (必需): 订单ID数组（最多20个）
• 返回: 成功确认，包含已删除ID的计数
• 用例: 批量清理、批量取消

验证工具

9. validate_shipping_order

• 目的: 在创建前验证订单以检查错误
• 参数: 与create_shipping_order相同
• 返回: 带有错误和警告的验证结果
• 用例: 防止失败的订单、验证地址准确性

运输标签工具

10. get_shipping_labels

• 目的: 为订单生成PDF运输标签
• 参数:
  • courier_id (必需): 快递标识符
  • profile (必需): 快递配置文件
  • shipping_numbers (必需): 运输编号数组
  • label_format (可选): ‘a4’、‘a6’或’zpl’ (默认: ‘a4’)
  • position (可选): 多标签表上的起始位置
• 返回: Base64编码的PDF或ZPL格式标签
• 用例: 打印包裹标签、自动化标签生成

取件管理工具

11. list_pickup_orders

• 目的: 获取符合快递取件条件的订单
• 参数:
  • date_from (可选): 开始日期 (YYYY-MM-DD)
  • date_to (可选): 结束日期 (YYYY-MM-DD)
  • state (可选): 按取件状态筛选
  • courier_id (可选): 按快递筛选
• 返回: 符合取件条件的订单，带有跟踪URL
• 用例: 准备每日取件、安排收集

12. create_pickup

• 目的: 安排快递取件请求
• 参数:
  • courier_id (必需): 快递标识符
  • shipping_numbers (必需): 要收集的运输编号数组
• 返回: 取件确认、取件编号、可选清单（base64）
• 用例: 自动化每日取件、协调收集

加入我们的新闻通讯

免费获取最新提示、趋势和优惠。

电子邮件地址

订阅

此MCP Server的使用案例

大量订单处理

周一早晨周末后高峰: 处理周末积累的200多个订单时，手动创建每个运输标签变得不可能。不用花费4-5小时点击仪表板，使用"为周五至周日的所有已付款订单创建运输订单，为每个目的地使用最佳快递"在几分钟内处理整批订单。AI自动根据目的地选择最佳快递，验证地址，生成标签，并提供跟踪号 - 将耗时一早上的任务转变为10分钟的操作。

闪购履行危机: 您的闪购在24小时内产生了350个订单，客户期望当天发货。手动处理将占用您整个团队一整天。命令"验证闪购批次中的所有订单，为有效地址创建运输标签，并标记有问题的订单以供审查"立即将340个准备发货的订单与需要地址更正的10个订单分开。您的仓库团队可以立即开始打包，而客户服务处理例外情况。

假日季节高峰管理: 在12月的高峰季节，您处理的数量是正常的5倍，临时员工没有接受过运输系统培训。不用花几小时培训他们使用复杂的仪表板，他们只需告诉AI"为[客户姓名和地址]创建GLS运输订单"，并立即收到打印的标签。这将培训时间从几小时减少到几分钟，并消除了最关键销售期间代价高昂的运输错误。

多快递费率优化

国际订单成本分析: 您收到45个国际订单，跨越12个国家。手动检查每个快递组合的运输费率将需要几个小时，并可能导致多付费用。询问"比较这些国际目的地所有可用快递的运输费率: [列表]"，立即查看哪个快递为每个国家提供最佳费率。这种单一分析每天可以节省数百的运输成本，同时确保更快的交货时间。

批量货物快递选择: 您需要将100个相同产品运送到不同的国内地址。不盲目使用默认快递，命令"分析100个包裹的快递选项，每个重量2kg，到这些地址。显示包括任何批量折扣在内的快递之间的总成本差异。“这表明从默认的DPD切换到GLS进行此批次可节省380欧元 - 在每次批量发货中累积的节省。

COD订单优化: 您今天有30个货到付款订单。并非所有快递都同样处理COD - 有些收取更高的费用，其他有更好的成功率。使用"哪些快递支持COD交付到这些地址，总运费和COD费用最低?“自动将每个订单路由到最具成本效益的支持COD的快递，将COD处理成本降低15-20%。

主动交付管理

延迟货物客户沟通: 周四下午，您知道一些客户期望周五交付。与其等待愤怒的电话，命令"显示所有计划周五交付但目前延迟或仍在运输中没有预期交付更新的包裹。“这识别出12个有风险的交付。您主动联系这些客户，提供更新的时间表和折扣代码，将潜在投诉转变为对您透明度的赞赏。

周末交付准备: 周五下午4点，您需要确定哪些订单在周一之前无法交付。询问"列出本周发货的所有订单，显示当前状态和预计交付。标记任何在周一之前无法到达客户的订单。“这立即揭示了18个卡在周末运输中的订单。您发送主动的周五晚上电子邮件，确认周一交付，大大减少周一早晨"我的订单在哪里?“的询问。

丢失包裹预防: 不用等待客户报告丢失包裹，运行每日检查：“显示所有发货超过7天但没有交付状态的包裹，按快递分组。“这个早期警告系统在客户注意到之前捕获卡在运输混乱中的包裹，允许您主动提交快递索赔并发送替代品。

仓库运营效率

跨多个地点的每日取件协调: 您经营三个仓库地点，每个都使用DPD、GLS和Packeta发货。手动协调六个单独的快递取件意味着六次电话和处理多个时间窗口。相反，命令"在所有地点为所有准备好的订单安排取件：华沙仓库用于DPD和GLS，布拉格仓库用于所有三个快递，柏林仓库仅用于DPD。“AI同时安排所有取件，提供确认号码，并生成清单 - 将90分钟的电话协调减少到3分钟的自然语言指令。

运输标签打印机队列管理: 您的仓库有三个打包站：一个有热敏打印机（A6标签），一个有标准打印机（A4标签），一个有Zebra打印机（ZPL格式）。不用手动按站分类订单，使用"为站一的订单1-50生成A6热敏标签，为站二的订单51-100生成A4标签，为站三的订单101-120生成ZPL格式。“每个打包站立即收到正确格式的标签，消除打印机兼容性错误和工作流程瓶颈。

一天结束时仓库对账: 在下午6点关闭之前，您需要验证所有拣选的订单都有运输标签，今天生成的所有标签实际上都被使用了。命令"显示所有标记为已拣选但没有运输标签的订单，以及今天生成但未分配给已拣选订单的所有标签。“这揭示了3个缺少标签的订单（拣货单完成但未创建货物）和2个为仍在等待拣选的订单生成的标签 - 允许您在仓库关闭前解决差异，而不是第二天早上发现它们。

地址验证和错误预防

批量订单地址验证: 您收到了一个包含150个员工地址的公司批量订单以进行礼品交付。处理这些而不进行验证会因拼写错误和不完整的地址而冒10-15%的失败率。不用创建失败的货物，运行"在创建订单之前验证此批次中的所有地址。将结果分组为已验证地址、需要小修复的可更正地址和需要客户联系的无效地址。“这可以防止交付失败，减少退货运费成本，并允许您在发货前而不是交付尝试失败后解决地址问题。

国际地址格式化: 您正在扩展到新的欧洲市场，但每个国家都有不同的地址格式要求。布拉格地址与柏林或维也纳地址有很大不同。不用研究每个国家的邮政法规，只需在创建前命令"验证此运输订单以交付到捷克共和国”。系统自动检查街道格式、邮政编码有效性和城市名称一致性 - 防止由于格式错误而被外国快递拒绝的包裹的挫折。

公寓和套房号码检测: 您注意到许多交付失败是由于缺少公寓号码 - 客户输入"Main Street 123"而没有"Apt 5B”。在处理今天的80个订单之前，运行"识别今天订单中所有没有公寓、套房、楼层或单元号码的地址。“这标记了12个可能不完整的地址。快速验证电话可以节省12次失败的交付、12次重新发货和12个沮丧的客户。

客户服务卓越

客户来电的即时订单状态: 您的客户服务每天收到50多个"我的订单在哪里?“电话。不用每个代理登录运输平台、查找订单、查找跟踪号、检查快递网站并解释状态，他们只需询问AI"为客户John Smith跟踪包裹，订单号2024-12345。“AI立即响应当前位置、交付状态和要共享的跟踪URL - 将平均通话处理时间从4分钟减少到45秒，并显著提高客户满意度。

VIP客户的批量状态更新: 您的企业客户下了一个订单，将200个单位运送到不同地点。他们想要所有货物的状态更新。不用手动检查200个跟踪号，使用"显示参考CLIENT-BULK-2024-001的所有订单的交付状态，按已交付、运输中和延迟分组。“在30秒内生成格式化报告，而不是花3小时手动跟踪检查。

退货标签生成: 客户想要退回他们的订单。不用通过多个系统屏幕创建退货标签，您的支持代理只需说"从[客户地址]到我们的仓库使用GLS创建退货运输标签，参考号RETURN-ORDER-12345。“客户在一分钟内通过电子邮件收到退货标签，改善退货体验并减少支持票证解决时间。

分析和成本管理

每月运费成本分析: 您怀疑运费超支，但缺乏时间手动分析数百个订单。命令"显示上个月按快递分组的所有订单，总运费成本、每个包裹的平均成本和交付成功率。“这揭示了虽然快递A似乎每个包裹更便宜，但其12%的交付失败率意味着每次成功交付的实际成本高于快递B的98%成功率。基于实际成本而非仅报价进行数据驱动的快递选择。

承运商绩效基准测试: 您与四个快递公司合作，但缺乏客观的绩效数据。使用"比较上季度所有快递：平均交付时间、准时交付百分比、交付失败率和平均成本。显示国内与国际运输的最佳表现者。“这揭示了DPD在国内速度方面表现出色，但GLS提供更好的国际可靠性 - 允许您战略性地路由订单，而不是使用一刀切的方法。

交付区域优化: 您正在考虑开设第二个仓库以改善交付时间。在投资之前，询问"分析我们运送到的所有邮政编码的交付时间，按地区分组。显示平均运输天数并识别始终慢速交付的区域。“这个地理分析揭示了您60%的3天以上交付都去往东南地区 - 验证了区域配送中心的商业案例并预测了潜在的交付时间改善。

季节性和促销活动支持

预活动容量规划: 您正在推出"免费送货星期五"促销，预计订单量是正常的3倍。询问"根据当前快递取件容量和安排，如果我们周五收到600个订单，每个快递可以处理多少订单?我们的最大处理容量是多少?“这揭示了您当前的快递协议最多支持450个订单。您在促销推出前主动与快递安排额外的取件容量，防止困扰去年促销的履行危机。

礼品季节多收件人订单: 在假日期间，许多客户订购运送到不同收件人的礼品。不用为一个客户的礼品清单手动创建8个单独的货物，使用"为客户ORDER-HOLIDAY-789创建运输订单：8个不同收件人在这些地址，全部使用礼品包装备注和相同的计费参考。“在几秒钟内处理复杂的多收件人订单，同时保持准确的订单归属以供客户服务和会计。

当日发货截止日期管理: 您承诺在下午2点前下单当日发货。在下午1:45，您需要确切知道哪些订单正在紧迫。命令"显示今天所有尚未创建运输标签的已付款订单。我们可以处理多少并安排当日发货的取件?“这揭示了23个订单需要立即关注。您在下午2点截止日期前优先处理这些订单，保持您的当日发货承诺和竞争优势。

如何设置

先决条件

• 安装Python 3.10或更高版本
• 拥有Chameleoon帐户并具有API访问权限（在chameleoon.sk注册）
• 有效的CHAMELEOON_API_KEY

Windsurf

1. 获取您的Chameleoon API密钥：

   • 登录您在chameleoon.sk的Chameleoon帐户
   • 导航到Settings > API Access
   • 生成或复制您的API密钥

2. 找到Windsurf的MCP配置文件：

   • macOS: ~/Library/Application Support/Windsurf/mcp.json
   • Windows: %APPDATA%\Windsurf\mcp.json
   • Linux: ~/.config/Windsurf/mcp.json

3. 添加Chameleoon MCP服务器配置：

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. 保存配置文件并完全重启Windsurf。

5. 验证连接：

   • 打开Windsurf的MCP面板
   • 在活动服务器列表中查找"chameleoon”
   • 尝试测试命令：“列出可用快递”

Claude Desktop

1. 从chameleoon.sk获取您的Chameleoon API凭据（参见先决条件）。

2. 找到Claude Desktop的配置：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. 更新或创建配置文件：

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. 保存文件并完全重启Claude Desktop（退出并重新启动）。

5. 确认服务器连接：

   • 打开Claude Desktop
   • 查找MCP集成面板
   • 验证"Chameleoon MCP Server"显示为已连接
   • 测试：“显示可用运输快递列表”

Cursor

1. 注册并在chameleoon.sk获得API访问权限（参见先决条件）。

2. 找到Cursor的MCP配置文件：

   • macOS: ~/Library/Application Support/Cursor/mcp.json
   • Windows: %APPDATA%\Cursor\mcp.json
   • Linux: ~/.config/Cursor/mcp.json

3. 添加MCP服务器条目：

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. 保存并重启Cursor。

5. 检查服务器状态：

   • 打开Cursor的MCP面板（View > MCP Servers）
   • 确保"chameleoon"显示为活动
   • 尝试：“列出本周的运输订单”

Cline

1. 从chameleoon.sk获取Chameleoon API密钥。

2. 找到Cline的配置文件（位置因Cline安装而异）。

3. 添加Chameleoon MCP服务器：

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. 保存、重启Cline并验证服务器出现在可用的MCP服务器中。

5. 测试连接：“获取快递配置列表”

安全最佳实践

切勿硬编码API密钥。 始终使用环境变量：

{
  "mcpServers": {
    "chameleoon": {
      "command": "python3",
      "args": ["-m", "chameleoon_mcp_server"],
      "env": {
        "CHAMELEOON_API_KEY": "${CHAMELEOON_API_KEY}"
      }
    }
  }
}

然后在系统级别设置环境变量：

• macOS/Linux: 添加到~/.bashrc或~/.zshrc: export CHAMELEOON_API_KEY="your_key"
• Windows: 通过System Properties > Environment Variables设置

在您的Chameleoon帐户中限制API密钥权限仅限所需操作。

定期轮换密钥并在泄露时立即撤销旧密钥。

为开发、暂存和生产环境使用单独的密钥。

如何在流程中使用此MCP

在FlowHunt中使用MCP

要将Chameleoon MCP Server集成到您的FlowHunt工作流程以实现自动化运输操作，请按照以下步骤操作：

1. 添加MCP组件:
   • 打开您的FlowHunt流程或创建新流程
   • 从组件面板拖动MCP组件
   • 将其连接到您的AI代理组件

2. 配置MCP服务器:
   • 单击MCP组件以打开配置
   • 在系统MCP配置部分，插入您的Chameleoon MCP服务器详细信息：

{
  "chameleoon": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/path/to/chameleoon/mcp"
  }
}

将URL替换为您实际的Chameleoon MCP服务器端点。

3. 设置环境变量:

   • 在FlowHunt的环境设置中，添加：
     • Key: CHAMELEOON_API_KEY
     • Value: 您的Chameleoon API密钥

4. 配置您的AI代理: 连接后，您的AI代理可以使用自然语言控制运输操作。示例提示：

   • “为客户John Smith在…创建运输订单”
   • “跟踪昨天的所有订单”
   • “为等待发货的订单生成标签”
   • “为DPD订单安排取件”

5. 构建自动化工作流程:

   示例：订单履行流程

   • 触发器：电子商务系统中的新订单
   • 操作1：提取客户地址和订单详细信息
   • 操作2：MCP组件指示AI：“使用这些详细信息创建运输订单：[订单数据]”
   • 操作3：存储运输编号和跟踪URL
   • 操作4：向客户发送确认电子邮件，包含跟踪链接

   示例：每日运输报告

   • 触发器：计划（每天上午9点）
   • 操作1：MCP组件询问AI：“列出昨天的所有订单”
   • 操作2：分析数据以获取见解
   • 操作3：生成摘要报告
   • 操作4：发送给物流团队

   示例：客户服务自动化

   • 触发器：带订单号的客户查询
   • 操作1：从消息中提取订单号
   • 操作2：MCP组件：“使用参考[order_number]跟踪包裹”
   • 操作3：格式化跟踪信息
   • 操作4：向客户发送状态和跟踪URL的响应

MCP Server评估

概述

我们的意见

Chameleoon MCP Server为运输管理自动化提供了强大的、生产就绪的集成。它以全面的工具覆盖整个运输生命周期的所有阶段而脱颖而出 - 从快递选择和订单创建到跟踪、标签生成和取件安排。

优势:

• 完整覆盖: 14个精心设计的工具，涵盖所有运输操作
• 多快递支持: 与DPD、GLS、Packeta和其他欧洲承运商合作
• 实用功能: 通用跟踪URL、多种标签格式、批量操作
• 以业务为重点: 电子商务、物流和小型企业的明确用例
• 注重安全: 环境变量配置，无硬编码凭据

最适合:

• 自动化订单履行的电子商务企业
• 管理多快递运营的物流团队
• 寻求运输自动化而无需复杂API的小型企业
• 在FlowHunt或类似平台中构建运输工作流程的开发人员
• 需要快速访问跟踪信息的客户服务团队

限制:

• 区域重点（主要是欧洲快递）
• 需要Chameleoon帐户和API访问
• 无公开资源（所有访问都基于工具）

该服务器将复杂的运输API交互转变为简单的自然语言命令，使非技术用户可以访问高级物流自动化，同时为高级用户提供全面的编程控制。

MCP评分

注意：分支和星标计数不可用，因为这是内部/专有MCP服务器实现。