Andrea Cosentino created CAMEL-23472:
----------------------------------------
Summary: camel-jbang-mcp: deduplicate @ToolArg descriptions to
shrink tool schema payload
Key: CAMEL-23472
URL: https://issues.apache.org/jira/browse/CAMEL-23472
Project: Camel
Issue Type: Improvement
Components: camel-jbang
Affects Versions: 4.21.0
Reporter: Andrea Cosentino
h3. Context
Part of an effort to reduce token consumption of the {{camel-jbang-mcp}} MCP
server. The module exposes 31 tools, 6 resources, and 3 prompts; both tool
schemas (loaded once per session) and tool results (per call) contribute to LLM
context-window pressure for every user of the server.
Related tickets in this effort are linked via "Relates to".
The {{camel-jbang-mcp}} module exposes 31 MCP tools whose schemas are sent to
the client on every session start. Several {{@ToolArg}} descriptions are
duplicated verbatim across tools, bloating the schema payload with roughly
1.5–2K tokens of pure repetition.
h3. Verified duplication counts in
{{dsl/camel-jbang/camel-jbang-mcp/src/main/java/.../mcp/}}
* {{Runtime type: main, spring-boot, or quarkus (default: main)}} — *18 copies*
* {{Platform BOM coordinates in GAV format ...}} (multi-line block) — *16
copies*
* {{Camel version to use ...}} — *12 copies*
* {{Version to query ...}} (longer variant) — *3 copies*
h3. Proposed change
* Introduce a {{ToolArgDocs}} constants class with {{RUNTIME}},
{{CAMEL_VERSION}}, {{PLATFORM_BOM}}, etc.
* Replace every duplicate description with the constant reference.
* Trim each text to the minimum necessary (e.g. {{runtime}} → {{"main |
spring-boot | quarkus"}}).
h3. Acceptance
No two {{@ToolArg}} annotations contain the same multi-line description literal.
----
_Filed by Claude Code on behalf of Andrea Cosentino_
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
