Camel MCP Server

Camel MCP Server 让 AI 编码助手深入了解 Apache Camel。它通过 Model Context Protocol (MCP) 暴露完整的 Camel 目录——组件、EIP、数据格式、Kamelet、示例——以及用于实时 Camel 应用的运行时内省工具。

MCP 服务器运行后，你的 AI 助手即可查阅组件文档、校验端点与路由、生成测试脚手架、根据堆栈跟踪诊断错误、检查依赖、规划迁移、审查路由的安全隐患，并与运行中的 Camel 应用交互——无需你复制粘贴任何内容。

基于 Quarkus 构建，并使用了 quarkus-mcp-server 扩展。

快速开始

最快的上手方式：

1. 安装 JBang（只需一次）
2. 运行 camel mcp（或 jbang org.apache.camel:camel-jbang-mcp:LATEST:runner）
3. 连接你的 AI 助手（参见下文的配置）

就这么简单——MCP 服务器会以 STDIO 传输方式启动，你的 AI 助手即可立即查询 Camel 目录、校验路由等等。

运行 MCP 服务器

运行 MCP 服务器有三种方式。

使用 Camel CLI（推荐）

camel mcp 命令将 MCP 服务器作为一等 CLI 命令启动：

camel mcp

这将以 STDIO 传输方式（默认）启动 MCP 服务器。要启用 HTTP 传输：

camel mcp --http
camel mcp --http --port 9090

有关所有可用标志，请参阅 camel mcp 选项。

直接使用 JBang

如果你已经安装了 JBang：

# STDIO transport (default)
jbang org.apache.camel:camel-jbang-mcp:LATEST:runner

# HTTP transport
jbang -Dquarkus.http.host-enabled=true -Dquarkus.http.port=8080 org.apache.camel:camel-jbang-mcp:LATEST:runner

使用 java -jar（无需 JBang）

从 Maven Central 下载 MCP 服务器的 uber-JAR 并直接运行：

# Download (replace VERSION with the desired Camel version, e.g., 4.21.0)
curl -O https://repo1.maven.org/maven2/org/apache/camel/camel-jbang-mcp/VERSION/camel-jbang-mcp-VERSION-runner.jar

# Run with STDIO transport
java -jar camel-jbang-mcp-VERSION-runner.jar

# Run with HTTP transport
java -Dquarkus.http.host-enabled=true -Dquarkus.http.port=8080 -jar camel-jbang-mcp-VERSION-runner.jar

传输方式

• STDIO（默认）—— 通过 stdin/stdout 进行通信。日志输出到 stderr。
• HTTP/SSE —— 面向基于 Web 的客户端以及远程/共享访问。可通过 --http 标志或 -Dquarkus.http.host-enabled=true 启用。支持两种变体：SSE（/mcp/sse，协议 2024-11-05）和可流式传输的 HTTP（/mcp，协议 2025-03-26，新集成推荐使用）。

设置

Claude Code（插件安装，推荐）

claude plugin marketplace add apache/camel
claude plugin install camel-mcp@camel-marketplace

手动配置（适用于所有 AI 工具）

将该服务器添加到你的 MCP 配置文件中。所有工具使用的 JSON 内容都相同，只有文件位置不同：

{
  "mcpServers": {
    "camel": {
      "command": "jbang",
      "args": [
        "-Dquarkus.log.level=WARN",
        "org.apache.camel:camel-jbang-mcp:LATEST:runner"
      ]
    }
  }
}

使用 MCP Inspector 检查

先启动启用了 HTTP 的服务器，然后：

npx @modelcontextprotocol/inspector

打开 http://localhost:6274/，将 Transport Type 设为 SSE，URL 设为 http://localhost:8080/mcp/sse，Connection 设为 Via Proxy。

camel mcp 选项

示例

以下是可以提供给 AI 助手的示例提示语。助手会自动选择合适的 MCP 工具。

目录探索

• “哪个组件支持 MQTT？” —— 使用 camel_catalog_find
• “显示 Kafka 组件的文档以及所有选项” —— 使用 camel_catalog_doc
• “哪个 EIP 会把消息扇出到多个端点？” —— 使用带 kind=eip 的 camel_catalog_find（fan-out、dedup 和 rate-limit 等 EIP 别名均可匹配）
• “显示所有 AWS 源 kamelet” —— 使用 camel_catalog_kamelets
• “aws-s3-source 接受哪些选项？” —— 使用 camel_catalog_kamelet_doc
• “显示适合初学者的 REST 示例” —— 使用 camel_catalog_examples

构建路由

让助手根据需求构建路由：

Build me a Camel route that generates a message every 5 seconds with a random number,
logs it, and sends it to a SEDA queue called "numbers".

助手会发现组件、查找文档、构建 YAML 路由，并使用 camel_validate_source 进行验证。使用 camel_build_integration 提示词可以获得结构化的多步骤工作流。

验证

• 「验证这个端点：kafka:myTopic?brkers=localhost:9092」 —— 检测出拼写错误并建议改为 brokers
• 「验证这个 YAML 路由」 —— 按照 YAML DSL JSON 模式进行检查，报告无效元素

理解、安全与测试

• 「解释这个路由的作用」 —— 使用 camel_route_context 进行基于组件目录的增强分析
• 「分析这个路由的安全隐患」 —— 使用 camel_route_harden_context 检测硬编码凭据、明文传输协议、已知 CVE 公告等
• 「我的 Camel 4.10.1 项目是否受已知 CVE 影响？」 —— 使用 camel_security_advisories 将已发布的 Apache Camel 安全公告与特定的 Camel 版本或组件进行匹配
• 「为这个路由生成一个 JUnit 5 测试」 —— 使用 camel_route_test_scaffold 生成包含 mock 端点和测试基础设施桩件的测试类

错误诊断

粘贴一段堆栈跟踪：

org.apache.camel.FailedToCreateRouteException: Failed to create route route1 at: >>> To[kafka:myTopic] <<<
Caused by: org.apache.camel.NoSuchEndpointException: No endpoint could be found for: kafka:myTopic

助手使用 camel_error_diagnose 来识别异常链、提取相关组件并给出修复建议（例如缺少 camel-kafka 依赖）。

依赖与版本

• "检查我的 pom.xml 中是否有缺失或过时的依赖" — 使用 camel_dependency_check
• "Spring Boot 目前最新的 LTS 版本是什么？" — 使用 camel_version_list
• "org.postgresql.ds.PGSimpleDataSource 需要哪个依赖？在 Quarkus 上该如何添加？" — 使用 camel_dependency_for_class

迁移

• "把我的项目迁移到最新版本（这是我的 pom.xml）" — 使用 camel_migration_analyze → camel_migration_compatibility → camel_migration_recipes
• "Camel 4 中 direct-vm 有哪些变化？" — 使用 camel_migration_guide_search
• "从 WildFly 迁移到 Quarkus" — 使用 camel_migration_wildfly_karaf 获取 archetype 命令和步骤
• 使用 camel_migrate_project 提示词来编排多步骤的完整迁移工作流

OpenAPI 契约优先

• "验证这份 OpenAPI 规范是否与 Camel 兼容" — 使用 camel_openapi_validate
• "生成一个带 mock 模式的 Camel YAML 脚手架" — 使用 camel_openapi_scaffold
• "展示 mock 目录结构" — 使用 camel_openapi_mock_guidance

将这三者组合起来，即可完成完整的原型开发工作流：先验证，再生成脚手架，然后逐条实现路由，其余部分由 Camel 进行 mock。

运行时内省

使用 camel run my-route.yaml 启动路由，然后提问：

• "展示正在运行的 Camel 进程和路由统计信息" — 使用 camel_runtime_processes 和 camel_runtime_routes
• "启用跟踪并展示被跟踪的消息" — 使用 camel_runtime_trace
• "向 direct:start 发送一条测试消息" — 使用 camel_runtime_send
• "哪些处理器最慢？" — 使用 camel_runtime_top
• "浏览 seda:numbers 中的消息" — 使用 camel_runtime_browse

提示词（结构化工作流）

支持提示词的 MCP 客户端会将以下内容作为可选择的工作流提供：

• camel_build_integration — 7 步引导式工作流：发现组件 → 选择 EIP → 构建 → 验证 → 安全审查
• camel_migrate_project — 6 步迁移流程：分析 → 兼容性 → 迁移方案 → 指南检索 → 总结
• camel_security_review — 3 步审计流程：分析漏洞 → 理解数据流 → 生成检查清单

可用工具

该服务器公开了一系列目录工具，用于探索组件、验证路由以及辅助迁移；还有运行时内省工具，用于检查和交互实时运行的 Camel 进程；此外还提供提示，给出结构化的多步骤工作流。

创作（与 Camel TUI 共享）

智能体构建和编辑集成所需的各种工具，只需在 Camel CLI 中定义一次，本服务器和 camel tui --mcp（参见 Camel TUI）都会以相同的 camel_ 名称对外暴露，因此智能体无论从哪个入口进入，得到的都是同一个 Camel。这些工具是自包含的：文件工具以项目的 directory 作为参数，运行时工具以集成的 name 作为参数（或者在仅有一个运行中集成时直接使用它）。

| camel_eval_expression | 在正在运行的集成中求值一个表达式（默认为 simple），未指定集成时在本地求值，并返回其值（谓词返回 true

目录浏览

Kamelet 目录

示例目录

路由理解

测试脚手架

安全分析

安全公告数据

安全公告数据随 MCP 服务器内置的 Camel 目录一同发布，其数据在构建 Camel 时从官方公开的 Apache Camel 安全公告（camel.apache.org/security 的数据来源）同步而来——与已知发布版本的同步方式完全相同。因此，所有查询均可完全离线进行；数据仅包含已发布的公告，其新鲜程度取决于 MCP 服务器所用的 Camel 版本：该版本发布之后公布的公告不会包含在内，因此请查看网页以获取最新信息。当目录中不包含安全公告数据时，这些工具会报告数据不可用，而不是返回空列表，从而避免将缺失的数据集误认为“不存在已知 CVE”。这些公告也可以作为 MCP 资源浏览：camel://security/advisories（完整列表）和 camel://security/advisory/{cve}（单个 CVE 的详情）。

错误诊断

依赖检查

校验与转换

路由图

OpenAPI 契约优先

从 Camel 4.6 起，基于 OpenAPI 规范构建 REST API 的推荐方式是契约优先：在运行时通过 rest:openApi 直接引用 OpenAPI 规范，而不是生成 REST DSL 代码。这些工具可帮助校验、搭建脚手架并为该工作流提供模拟指导。

迁移

版本管理

运行时内省

进程发现

上下文与路由

可观测性

数据、弹性与分析

配置与注册表

交互与调试

可用提示（Prompt）

提示是结构化的多步骤工作流，用于引导 LLM 按正确顺序编排调用多个工具。LLM 无需自行判断应调用哪些工具以及以何种顺序调用，提示会以分步计划的形式提供完整的工作流。

支持提示的 MCP 客户端（如 Claude Desktop）会将提示作为可选择的工作流暴露出来。LLM 接收指令，并通过调用其中引用的工具来逐步执行每个步骤。