@@ -23,10 +23,10 @@ entirely. No other Java framework can do all three from the same service deploym
2323
2424---
2525
26- ## Immediate Track — MCP inputSchema + Axis2/C + Penguin Demo
26+ ## Immediate Track — MCP inputSchema + Axis2/C + Apache httpd Demo
2727
2828** Goal** : Complete the MCP catalog to production quality, port the catalog handler to
29- Axis2/C, and run a live demo on penguin via Apache httpd. This track runs ahead of
29+ Axis2/C, and run a live demo on Apache httpd with mod_axis2 . This track runs ahead of
3030Phases 1–6 because it validates the MCP story end-to-end on real hardware.
3131
3232### Step B1 — ` mcpInputSchema ` static parameter support (Java + C)
@@ -171,9 +171,9 @@ it. The 5 operations:
171171| ` generateTestData ` | ` n_assets ` |
172172| ` metadata ` | * (none — GET operation)* |
173173
174- ### Step E — Penguin deployment
174+ ### Step E — Apache httpd deployment
175175
176- 1 . Build ` mod_axis2.so ` from ` axis-axis2-c-core ` targeting penguin 's Apache httpd
176+ 1 . Build ` mod_axis2.so ` from ` axis-axis2-c-core ` targeting the host 's Apache httpd
1771772 . ` httpd.conf ` fragment:
178178 ``` apache
179179 LoadModule axis2_module modules/mod_axis2.so
@@ -185,8 +185,8 @@ it. The 5 operations:
1851853 . Deploy ` FinancialBenchmarkService ` to repository
1861864 . Verify:
187187 ``` bash
188- curl https://penguin /axis2/_mcp/openapi-mcp.json
189- curl -X POST https://penguin /axis2/services/FinancialBenchmarkService/monteCarlo \
188+ curl https://localhost /axis2/_mcp/openapi-mcp.json
189+ curl -X POST https://localhost /axis2/services/FinancialBenchmarkService/monteCarlo \
190190 -H ' Content-Type: application/json' \
191191 -d ' {"monteCarlo":[{"arg0":{"n_simulations":10000,"n_periods":252,...}}]}'
192192 ```
@@ -340,9 +340,9 @@ Phase 1 (starter) — OpenAPI endpoints auto-registered via starter autoconfigur
340340JSON-RPC path and a new REST path, with proper HTTP method semantics and
341341resource-oriented URLs.
342342
343- **Problem today**: RAPI ' s service URLs (`POST /services/getAssetCalculationsService /
344- doGetAssetCalculationsJob `) are JSON-RPC over HTTP. New consumers (Data API , React
345- frontend , MCP agents) expect `GET /api/v1/funds /{id}/calculations`. Axis2 has REST
343+ **Problem today**: Existing Axis2 service URLs (`POST /services/calculationService /
344+ doCalculationJob `) are JSON-RPC over HTTP. New consumers (REST APIs , React
345+ frontends , MCP agents) expect `GET /api/v1/resources /{id}/calculations`. Axis2 has REST
346346dispatch capability in `axis2.xml` but it has never been activated or documented for
347347modern Spring Boot deployments.
348348
@@ -395,8 +395,8 @@ modern Spring Boot deployments.
395395
396396# ## Deliverable
397397Existing Axis2 services add `@RestMapping` annotations and are immediately available
398- as REST endpoints alongside their JSON-RPC paths. RAPI services can be exposed to Data
399- API consumers without rewriting or duplicating service logic.
398+ as REST endpoints alongside their JSON-RPC paths. Existing JSON-RPC services can be
399+ exposed to REST and MCP consumers without rewriting or duplicating service logic.
400400
401401# ## Dependency
402402Phase 1 (starter registers both dispatchers), Phase 2 (REST paths appear in OpenAPI
@@ -574,7 +574,7 @@ understand the multi-protocol positioning, and have concrete migration guides.
574574 reference implementation in the distribution
575575 - README updated to reflect starter usage once Phase 1 ships
576576
577- 4. **Migration guide: RAPI JSON-RPC → Dual-Protocol**
577+ 4. **Migration guide: JSON-RPC → Dual-Protocol**
578578 - Step-by-step: add `@RestMapping` annotations, enable REST dispatcher, verify
579579 both paths, update OpenAPI spec, expose MCP tools
580580 - Targets teams running Axis2 JSON-RPC who want REST and MCP without rewriting
@@ -608,7 +608,7 @@ Claude Desktop / AI agent → MCP (native transport, Phase 6)
608608 ↓
609609Data API / React frontend → REST (Phase 3) ──► Axis2 Service
610610 ↑ (one implementation)
611- Existing RAPI callers → JSON-RPC (unchanged)
611+ Existing JSON-RPC callers → JSON-RPC (unchanged)
612612```
613613
614614With OpenAPI spec and MCP tool definitions auto-generated (Phase 2) and a Spring Boot
0 commit comments