Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"name": "camel-marketplace",
"description": "Apache Camel plugins for Claude Code, including the Camel MCP server.",
"owner": {
"name": "Apache Camel",
"email": "dev@camel.apache.org",
"url": "https://camel.apache.org"
},
"plugins": [
{
"name": "camel-mcp",
"source": "./plugins/camel-mcp",
"description": "Apache Camel MCP server: exposes the Camel Catalog plus specialized tools (catalog exploration, route and YAML DSL validation, security hardening, error diagnosis, dependency check, OpenAPI contract-first scaffolding, and version-to-version migration) to AI coding assistants over the Model Context Protocol. Requires JBang on the PATH."
}
]
}
32 changes: 25 additions & 7 deletions docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -410,7 +410,25 @@ The MCP server requires https://www.jbang.dev/[JBang] to be installed and availa

=== Claude Code

Add the following to your project's `.mcp.json` (or `~/.claude/mcp.json` for global configuration):
==== Install as a plugin (recommended)

Claude Code can install the Camel MCP server from the marketplace defined in the `apache/camel`
repository, so you do not have to edit any configuration file by hand. JBang must still be installed
and available on your PATH.

[source,bash]
----
claude plugin marketplace add apache/camel
claude plugin install camel-mcp@camel-marketplace
----

The first command registers the marketplace; the second installs the `camel-mcp` plugin, which ships
the MCP server configuration. The server is launched on demand over STDIO via JBang.

==== Manual configuration

Alternatively, add the following to your project's `.mcp.json` (or `~/.claude/mcp.json` for global
configuration):

[source,json]
----
Expand All @@ -420,7 +438,7 @@ Add the following to your project's `.mcp.json` (or `~/.claude/mcp.json` for glo
"command": "jbang",
"args": [
"-Dquarkus.log.level=WARN",
"org.apache.camel:camel-jbang-mcp:4.18.0:runner"
"org.apache.camel:camel-jbang-mcp:LATEST:runner"
]
}
}
Expand All @@ -439,7 +457,7 @@ Add the server to your MCP configuration:
"command": "jbang",
"args": [
"-Dquarkus.log.level=WARN",
"org.apache.camel:camel-jbang-mcp:4.18.0:runner"
"org.apache.camel:camel-jbang-mcp:LATEST:runner"
]
}
}
Expand All @@ -458,7 +476,7 @@ Configure MCP servers in your `.vscode/mcp.json` or in the user settings:
"command": "jbang",
"args": [
"-Dquarkus.log.level=WARN",
"org.apache.camel:camel-jbang-mcp:4.18.0:runner"
"org.apache.camel:camel-jbang-mcp:LATEST:runner"
]
}
}
Expand All @@ -478,7 +496,7 @@ Settings > Tools > AI Assistant > MCP Servers, or create an `.junie/mcp.json` fi
"command": "jbang",
"args": [
"-Dquarkus.log.level=WARN",
"org.apache.camel:camel-jbang-mcp:4.18.0:runner"
"org.apache.camel:camel-jbang-mcp:LATEST:runner"
]
}
}
Expand All @@ -491,7 +509,7 @@ Any MCP client that supports the STDIO transport can launch the server directly:

[source,bash]
----
jbang org.apache.camel:camel-jbang-mcp:4.18.0:runner
jbang org.apache.camel:camel-jbang-mcp:LATEST:runner
----

=== HTTP/SSE Transport
Expand All @@ -500,7 +518,7 @@ To start the server with the HTTP/SSE transport enabled:

[source,bash]
----
jbang -Dquarkus.http.host-enabled=true -Dquarkus.http.port=8080 org.apache.camel:camel-jbang-mcp:4.18.0:runner
jbang -Dquarkus.http.host-enabled=true -Dquarkus.http.port=8080 org.apache.camel:camel-jbang-mcp:LATEST:runner
----

If you have built Camel locally, you can also run the uber-JAR directly:
Expand Down
24 changes: 24 additions & 0 deletions plugins/camel-mcp/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
{
"name": "camel-mcp",
"version": "0.1.0",
"description": "Apache Camel MCP server for AI coding assistants. Launches the Camel JBang MCP server (org.apache.camel:camel-jbang-mcp) over STDIO, exposing the Camel Catalog and tools for catalog exploration, route and YAML DSL validation, security hardening, error diagnosis, dependency check, OpenAPI contract-first scaffolding, and migration. Requires JBang on the PATH.",
"author": {
"name": "Apache Camel",
"email": "dev@camel.apache.org",
"url": "https://camel.apache.org"
},
"homepage": "https://camel.apache.org/manual/camel-jbang-mcp.html",
"repository": "https://github.com/apache/camel",
"license": "Apache-2.0",
"keywords": [
"camel",
"java",
"integration",
"mcp",
"model-context-protocol",
"jbang",
"spring-boot",
"quarkus",
"catalog"
]
}
11 changes: 11 additions & 0 deletions plugins/camel-mcp/.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"mcpServers": {
"camel": {
"command": "jbang",
"args": [
"-Dquarkus.log.level=WARN",
"org.apache.camel:camel-jbang-mcp:LATEST:runner"
]
}
}
}