mcp-server-rocketmq
๐ ้กน็ฎ็ฎไป
mcp-server-rocketmq ๆฏไธไธบ Apache RocketMQ 5 ๆ้ ็ไผไธ็บงๆบ่ฝๅ่ฟๆฅๆๅก๏ผๅฎๅ
จ้ตๅพชๅผๆพๆ ๅ Model Context Protocol (MCP) ่ง่่ฎพ่ฎก๏ผๅบไบ Spring AI 2 (2.0.1) + Spring Boot 4 (4.1.0) + JDK 21 ็ฐไปฃไบๅ็ๆๆฏๆ ๆๅปบใ
ๅฎๅฐๅคง่ฏญ่จๆจกๅๆบ่ฝไฝ๏ผๅฆ Claude DesktopใCursorใAntigravity ็ญๅ็ฑป AI ็ผ็จๅฉๆไธๆบ่ฝ่ฟ็ปด Agent๏ผไธๅๅธๅผๆถๆฏไธญ้ดไปถ Apache RocketMQ 5 ๆทฑๅบฆๆ้ใ้่ฟๆด้ฒๆ ๅๅ็ MCP Tools๏ผๅทฅๅ ท๏ผใResources๏ผๅช่ฏป่ตๆบ๏ผ ไธ Prompts๏ผไธๅฎถๆ้ๅทฅไฝๆต๏ผ๏ผ่ต่ฝๆบ่ฝไฝ้่ฟ่ช็ถ่ฏญ่จ็ดๆฅๆขๆฅ้็พคๅฅๅบทใ็ง็บงๅฎไฝๆถ่ดนๅ ็งฏใๅ จ้พ่ทฏๆฃ็ดขๆถๆฏใๆๆฅๆญปไฟกๆ นๅ ๏ผๅนถๅฎๅ จๅๆงๅฐๆง่กๆถๆฏๆถๅไธไฝ็นๆฒป็ใ
๐๏ธ ็ณป็ปๆๆๆถๆ
ๆฌ้กน็ฎ้็จ Remoting ๆทฑๅบฆ่ฟ็ปด็ฎก็ + gRPC ไบๅ็ๆถๆฏๆถๅ ็ๆททๅๅ้ฉฑๅจๆถๆ๏ผ่ฏฆ่ง ADR 0001๏ผ๏ผ
flowchart TD
subgraph AI_Clients["AI ๅฎฟไธปๅฎขๆท็ซฏ (MCP Host)"]
Claude["Claude Desktop"]
Cursor["Cursor / IDE"]
Agent["Antigravity / ๆบ่ฝ่ฟ็ปด Agent"]
end
subgraph MCP_Server["mcp-server-rocketmq (Spring Boot 4 + Spring AI 2)"]
direction TB
subgraph Transport_Layer["ไผ ่พๅ่ฎฎ่ช้ๅบๅฑ"]
Stdio["Stdio ไผ ่พ (ๆงๅถๅฐๆฅๅฟ้ๅฎๅ่ณ stderr๏ผไฟ่ฏ stdout ็บฏๅ)"]
SSE["WebMVC SSE / Streamable HTTP (็ฌ็ซ็ฝ็ปๅพฎๆๅก)"]
end
subgraph Safety_Guards["ๅ็ปด็ไบง็บงๅฎๅ
จๆฆๆชๅฑ"]
ReadOnlyGuard["ๅช่ฏปๅฎๅซ (Read-Only Guard)"]
DualLayerGuard["็ ดๅๆงๆไฝๅๅฑ้ฒๅ (Dual-Layer Guard)"]
BodyGuard["ๆถๆฏไฝ 4KB ๆชๆญ้ฒๆค (Message Body Guard)"]
SysFilter["็ณป็ปๅ
็ฝฎไธป้ข้้ป่ฟๆปค (System Topic Filter)"]
end
subgraph MCP_Layer["MCP ๅ
จๅ่ฎฎไธ็ปด่ฆ็ด ๅฑ"]
Tools["18 ้กนๆ ธๅฟ MCP Tools"]
Resources["3 ้กนๅช่ฏป MCP Resources"]
Prompts["2 ้กน้ข็ฝฎไธๅฎถ Prompts ๅทฅไฝๆต"]
end
subgraph Client_Drivers["RocketMQ ๆททๅ้ฉฑๅจๅฑ"]
AdminDriver["Remoting ่ฟ็ปด้ฉฑๅจ (DefaultMQAdminExt ๅไพๅ็ฎก)"]
GrpcDriver["gRPC ๆถๆฏ้ฉฑๅจ (rocketmq-client-java 5.2.2)"]
end
end
subgraph RocketMQ5_Cluster["Apache RocketMQ 5.x ้็พค"]
NameServer["NameServer ้็พค (็ซฏๅฃ 9876)"]
Proxy["RocketMQ 5 Proxy ็ซฏ็น (gRPC ็ซฏๅฃ 8081)"]
Broker["Broker ๆถๆฏๅญๅจ่็น"]
end
Claude -->|stdio| Stdio
Cursor -->|stdio| Stdio
Agent -->|HTTP/SSE| SSE
Stdio --> Safety_Guards
SSE --> Safety_Guards
Safety_Guards --> MCP_Layer
MCP_Layer --> Client_Drivers
AdminDriver -->|Remoting ๅ่ฎฎ| NameServer
AdminDriver -.->|Remoting ๅ่ฎฎ| Broker
GrpcDriver -->|gRPC ๅ่ฎฎ| Proxy
Proxy -.-> Broker
โจ ๆ ธๅฟ่ฝๅไธ MCP ๅ่ฎฎ่ฆ็ด ็ฉ้ต
ๆฌ้กน็ฎๅฎๆด่ฝๅฐ Model Context Protocol ็ไธๅคงๆ ธๅฟๆฏๆฑ๏ผ
1. ๐งฐ MCP Tools ๆ ธๅฟๅทฅๅ ท้ (ๅ ฑ 18 ้กนๅทฅๅ ท)
๐ ๆณจ๏ผๅๆฐๅ ็ฒ่กจ็คบๅฟ ๅกซ้กน๏ผๅธฆ
?่กจ็คบๅฏ้ๅๆฐ๏ผ็ ดๅๆงๅทฅๅ ทๅฟ ้กป็ฑๆจกๅๆพๅผไผ ๅ ฅconfirm: trueไธๅฏๅจ้ ็ฝฎๆพ่ก๏ผๅฆๅๅฐ่ขซๅๅฑ้ฒๅๆฆๆชใ
2. ๐ MCP Resources (ๅช่ฏปไธไธๆ่ตๆบ)
ๅฎขๆท็ซฏ่ฟๆฅๆถๆ ้ไธปๅจ่ฐ็จๅทฅๅ ท๏ผๅณๅฏๅฐ้็พคๅบ็กๆๆ็ดๆฅไฝไธบๅช่ฏปไธไธๆๆ่ฝฝ่ฟไผ่ฏ๏ผ
rocketmq://cluster/topology๏ผ้็พค็ฉ็ๆๆๅฟซ็ ง๏ผๅ ๅซ Broker ่็นๅใ่ง่ฒ Master/Slaveใๅฐๅๅๅฅๅบท็ถๆ๏ผใrocketmq://topics๏ผๅฝๅ้็พคๆๆไธๅกไธป้ขๆธ ๅไธ้ๅๅๅธๆฆ่งใrocketmq://server/status๏ผMCP Server ่ช่บซ่ฟ่กๆถ้ ็ฝฎไธ้ฒๆค็ญ็ฅ๏ผๅช่ฏป็ถๆใ็ ดๅๆงๅทฅๅ ทๅผๅฏ็ถๆ๏ผใ
3. ๐ก MCP Prompts (ไธๅฎถ้ข็ฝฎๅทฅไฝๆต)
ๅฎขๆท็ซฏๅฏไธ้ฎ่งฆๅ้ๅฏนๅคๆๆ ้ๅบๆฏ็ๆ ๅๅ็ผๆๅทฅไฝๆต๏ผ
diagnose_consumer_lag๏ผๆถ่ดนๅ ็งฏๆทฑๅบฆๆ้ๆต๏ผ๏ผ ๅผๅฏผ AI ่ชๅจไธฒ่๏ผrocketmq_top_consumer_lag๏ผๅฎไฝๆ ข็ป๏ผ$\rightarrow$rocketmq_consumer_status๏ผๆฃๆฅๆถ่ดน่ ๅฎขๆท็ซฏๆดป่ทๅบฆ๏ผ$\rightarrow$rocketmq_query_dlq_messages๏ผๆๆฅๆญปไฟก๏ผ$\rightarrow$ ่พๅบๆ นๅ ็ป่ฎบไธๆฉๅฎน/ไฝ็น้็ฝฎๆฒป็ๅปบ่ฎฎใcluster_health_check๏ผ้็พคๅฅๅบทๅ จ้ขๅทกๆฃๆต๏ผ๏ผ ๅ จ้ขๅทกๆฃๆๆ Broker ่็นๅๅใ็ฉ็็ฃ็ๆฐดไฝใ่ฏปๅ้ๅๅๅธไธไธๅกไธป้ขๅฎน้๏ผ่ชๅจๆฑๆปไธบ็ปๆๅ Markdown ไฝๆฃๅจๆฅใ
๐ก๏ธ ๅ็ปด็ไบง็บงๅฎๅ จ้ฒๅพกไฝ็ณป
ๅคง่ฏญ่จๆจกๅๅ ทๆ็ๆๅนป่งไธ็่งฃๆญงไน็้ฃ้ฉใไธบ็กฎไฟไผไธๆถๆฏ้ๅ็็ปๅฏนๅฎๅ จ๏ผๆฌ้กน็ฎๆๅปบไบๅ็ปดๅฎๅ จๅฑ้๏ผ
- ๅช่ฏปไฟๆคๅฎๅซ (Read-Only Guard)๏ผ
่ฎพ็ฝฎ
ROCKETMQ_READ_ONLY=trueๆถ๏ผๆๅกๅฐๅฝปๅบๅฐ้ๆๆๆถๆฏๅ้ใไธป้ขๅๅปบ/ๅ ้คใไฝ็น้็ฝฎไธๆญปไฟก้ๆๅทฅๅ ทใ - ๅๅฑ้ฒๅๆบๅถ (Dual-Layer Guard)๏ผ
้ๅฏน็ ดๅๆงๅทฅๅ
ท๏ผๅ ้ค Topicใ้็ฝฎไฝ็นใๆญปไฟก้ๆ๏ผ๏ผๅฟ
้กปๅๆถๆปก่ถณไธคๅฑๆ ก้ชๆนๅฏๆง่ก๏ผ
- ๅฑ็บงไธ๏ผๅฏๅจ็บง็ฏๅขๅผๅ
ณ๏ผ๏ผๅฟ
้กปๆพๅผ้
็ฝฎ
ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS=true๏ผ - ๅฑ็บงไบ๏ผ่ฐ็จ็บงๆพๅผ็กฎ่ฎค๏ผ๏ผAI ๅฟ
้กปๅจๅ
ฅๅไธญๆพๅผไผ ๅ
ฅ
confirm: true๏ผๅฆๅ่ขซ็ญ่ทฏๆฆๆชใ
- ๅฑ็บงไธ๏ผๅฏๅจ็บง็ฏๅขๅผๅ
ณ๏ผ๏ผๅฟ
้กปๆพๅผ้
็ฝฎ
- ็ณป็ปไธป้ข้้ปๅฑ่ฝ (System Topic Filter)๏ผ
่ชๅจๆฆๆชๅนถ้่ไปฅ
%SYS%ใTBW102ใBenchmarkTestใSCHEDULE_TOPIC็ญๅผๅคด็ๅ ้จ็ฎก็ไธป้ข๏ผ้ฟๅ ๆจกๅ็ ดๅ้็พคๅบ็กๆๅกใ - ๆถๆฏไฝ้ฒ็ๆชๆญ (Message Body Guard)๏ผ ๆถๆฏๅ ๅฎนไผๅ ๆ UTF-8 ่งฃ็ ๏ผๅคฑ่ดฅ่ชๅจ้็บงไธบ Base64ใๅฏน่ถ ่ฟ 4KB ็ๆถๆฏไฝ่ชๅจๅฎๅ จๆชๆญๅนถ้ๅธฆๅ ๆฐๆฎๆ็คบ๏ผๅฝปๅบๆ็ป่ถ ้ฟๆฅๆ็็ ด LLM ไธไธๆ็ชๅฃใ
๐ฌ ๅ ธๅไบคไบๅฎๆ๏ผAI ๆฏๅฆไฝๅธฎๆๆ้็๏ผ
ๆฅๅ
ฅ mcp-server-rocketmq ๅ๏ผไฝ ๅฏไปฅ็ดๆฅๅจ่ๅคฉๆก็จ่ช็ถ่ฏญ่จไธ AI ๅๅๅฎๆๅ็งๅคๆ่ฟ็ปดๅบๆฏ๏ผ
ๅบๆฏ 1๏ผ็ง็บงๅฎไฝๆถ่ดนๅ ็งฏไธๆ ขๆถ่ดนๅฎไพ
๐ค ็จๆท๏ผโๆ่ฟ่ฎขๅ็ณป็ปๆถ่ดนๅฅฝๅๅพๆ ข๏ผๅธฎๆๆฅไธไธ้็พค้ๆๆฒกๆ็งฏๅๆไธฅ้็้ฎ้ขๆถ่ดน็ป๏ผๅนถๅๆๆ ขๆถ่ดน่ ๅฎไพใโ
๐ค AI ๆ่ไธๅจไฝ๏ผ
- ่ฐ็จ
rocketmq_top_consumer_lagๅทฅๅ ท๏ผ่ทๅๅฝๅๅ ็งฏ้ Top 5 ็ๆถ่ดน็ป๏ผ- ๅ็ฐ
order_payment_consumer_group็งฏๅไบ 128,400 ๆกๆถๆฏ๏ผ- ่ชๅจ่ฐ็จ
rocketmq_consumer_status(group: "order_payment_consumer_group")่ทๅ่ฏฅ็ป็ๅจ็บฟๅฎขๆท็ซฏๅ่กจ๏ผ- ๅ็ฐ 4 ไธชๆถ่ดนๅฎไพไธญๆ 1 ไธชๅฎไพ็ๅค็ไฝ็นๅๆปไธ IP ไธ้๏ผ
๐ AI ่ฏๆญๅ้ฆ๏ผ
โ็ปๆๆฅ๏ผๅฝๅ้็พค็งฏๅๆไธฅ้็ๆฏ
order_payment_consumer_group๏ผ็ดฏ่ฎก็งฏๅ 12.8 ไธๆก๏ผใ ่ฏฅ็ปๅ ฑๆ 4 ไธชๅฎขๆท็ซฏๅฎไพ๏ผๅ ถไธญไฝไบ192.168.1.152็่็น่ช 20 ๅ้ๅๆ ๅฟ่ทณ่ฟๅบฆ๏ผๅฏผ่ดๅ้ ็ป่ฏฅๅฎไพ็ 2 ไธช Queue ๅฎๅ จ้ปๅกใๅปบ่ฎฎไผๅ ้ๅฏ่ฏฅๅฎไพๆ่งฆๅ้ๅนณ่กก้ๆพๅๅบใโ
ๅบๆฏ 2๏ผๆ นๆฎไธๅก่ฎขๅๅทๅ จ้พ่ทฏ่ฟฝ่ธชๆถๆฏ
๐ค ็จๆท๏ผโ็จๆทๆ่ฏ่ฎขๅๅท
ORD_20261004_9921ๆฒกๆถๅฐๅ่ดง้็ฅ๏ผๅธฎๆๆฅไธไธ่ฟ็ฌ่ฎขๅ็ๆถๆฏๆๆฒกๆๅๅบๆฅใ็ฎๅๅฐๅชไธๆญฅไบ๏ผโ๐ค AI ๆ่ไธๅจไฝ๏ผ
- ่ฐ็จ
rocketmq_query_message_by_key(topic: "order_events_topic", key: "ORD_20261004_9921")๏ผ- ่ทๅๅฐ Message ID
0A00010200002A9F000000000012C3D4๏ผๆถๆฏไฝ็ป้ฒ็ๅฎๅ จ่งฃๆไธบ JSON ๆ ผๅผ๏ผ- ่ชๅจ่ฐ็จ
rocketmq_query_message_trace(msgId: "0A00010200002A9F000000000012C3D4")๏ผ๐ AI ่ฏๆญๅ้ฆ๏ผ
โๅทฒๆๅๅฎไฝ่ฎขๅๆถๆฏ๏ผ
- Message ID:
0A00010200002A9F000000000012C3D4- ๅ้ๆถ้ด:
2026-10-04 20:15:32- ่ฝจ่ฟนๅๆ: ๆถๆฏๅทฒๅจ
Broker-a (Queue 2)ๆญฃๅธธๆไน ๅ๏ผไฝไธๆธธlogistics_notice_groupๅจๆถ่ดน่ฟ็จไธญๆๅบไบๅค้จ็ญไฟก็ฝๅ ณ่ถ ๆถๅผๅธธ๏ผๆถๆฏๅทฒ่ขซๆ้ๅฐ้่ฏ้ๅ็ฌฌ 3 ๆฌกใโ
ๅบๆฏ 3๏ผๆญปไฟก้ๅๆๆฅไธๅฎๅ จ้ๆ่ชๆ
๐ค ็จๆท๏ผโๆฅไธไธๆฏไปๆถ่ดน็ปๆ่ฟไบง็็ๆญปไฟกๆถๆฏ๏ผๅๆไธไธๅคฑ่ดฅๅๅ ๏ผๅฆๆๆฒก้ฎ้ข็่ฏๅธฎๆ้ๆฐๆ้ๅไธๅกไธป้ข้่ฏใโ
๐ค AI ๆ่ไธๅจไฝ๏ผ
- ่ฐ็จ
rocketmq_query_dlq_messages(group: "payment_process_group")๏ผๆๅๆญปไฟก้ๅๆ่ฟๅคฑ่ดฅๆถๆฏ๏ผ- ๅ็ฐๆญปไฟกไธป่ฆ็ฑไบ็ฌฌไธๆนๆฏไปๅ่ฐๆฅๅฃ้ๆตๅฏผ่ด๏ผ
- ๅ็จๆทๆฑๆฅๅๅ ๅ๏ผ่ฐ็จๅไฟๆค็็ ดๅๆงๅทฅๅ ท๏ผ
rocketmq_resend_dlq_message(group: "payment_process_group", msgId: "0A000...", targetTopic: "payment_order_topic", confirm: true)๏ผ๐ AI ่ฏๆญๅ้ฆ๏ผ
โๅทฒๆฃ็ดขๅฐ่ฏฅๆญปไฟกๆถๆฏไฝ๏ผๆฅ้ๅๅ ไธบไธๆธธ็ฝๅ ณ 429 Too Many Requestsใ็ฎๅ็ฝๅ ณๅทฒๆขๅค๏ผๅจๆจๆๆๅ๏ผๆๅทฒ้่ฟๆพๅผ็กฎ่ฎคๅๆฐๅฐๆถๆฏ้ๆฐๅๅไธๅกไธป้ข
payment_order_topic๏ผๅทฒ่ขซๆถ่ดนๆนๆๅๆฅๆถๅค็๏ผโ
ๅบๆฏ 4๏ผไธ้ฎ็ๆ้็พคๅฅๅบทๅทกๆฃๅจๆฅ
๐ค ็จๆท๏ผโๅธฎๆๅฏนๅฝๅ RocketMQ ้็พคๅไธๆฌกๅ จ้ข็ๅฅๅบทๅทกๆฃ๏ผ่พๅบไธไปฝ Markdown ๅจๆฅใโ
๐ค AI ๆ่ไธๅจไฝ๏ผ ่ชๅจ่งฆๅ MCP ้ข็ฝฎไธๅฎถๅทฅไฝๆต
cluster_health_check๏ผไธฒ่ Broker ็ฃ็/TPS ๆฃๆฅไธๆ ธๅฟไธๅกไธป้ข่ฏปๅ้ๅๅ่กกๅๅธๅๆใ
ๅบๆฏ 5๏ผ่ทจ็ฏๅขๅค้็พคๆฏๅฏนไธๆ ้ๅค็ฐ (Multi-Cluster Collaboration)
๐ค ็จๆท๏ผโๅธฎๆๆฏๅฏนไธไธ
rocketmq-devๅrocketmq-prodไธ็trade_order_topic้ๅ้ ็ฝฎๆฏๅฆไธ่ด๏ผๅฆๅคๆฅไธไธ็ไบงๆญปไฟก๏ผๆๆญปไฟกๅ ๅฎนไฝไธบๆต่ฏๆถๆฏๅๅฐ dev ้็พค่ฎฉๆๆฌๅฐ่ฐ่ฏใโ๐ค AI ๆ่ไธๅจไฝ๏ผ
- ๅๅซ่ฐ็จ
rocketmq-dev:rocketmq_topic_routeไธrocketmq-prod:rocketmq_topic_route๏ผ- ๅ็ฐ็ไบง็ฏๅข่ฏปๅ้ๅๆฐๅไธบ 16๏ผ่ๅผๅ็ฏๅขไป ไธบ 8๏ผ
- ่ฐ็จ็ไบงๅช่ฏปๅฎไพ
rocketmq-prod:rocketmq_query_dlq_messages(group: "trade_group")ๆๅๅคฑ่ดฅๆญปไฟก Payload๏ผ- ๅฐๆๅๅฐ็ Payload ่ฐ็จๅผๅๅฎไพๅ้ๅทฅๅ ท
rocketmq-dev:rocketmq_send_message(topic: "trade_order_topic", body: payload)๏ผๅฎๅ จๅค็ฐ๏ผ๐ AI ่ฏๆญๅ้ฆ๏ผ
โ้ ็ฝฎๆฏๅฏน็ป่ฎบ๏ผ
- ็ไบง็ฏๅข (
rocketmq-prod): ่ฏปๅ้ๅๅ 16 ไธช๏ผๅๅธไบ 2 ไธช Master Broker๏ผ- ๅผๅ็ฏๅข (
rocketmq-dev): ่ฏปๅ้ๅๅ 8 ไธช๏ผๅๅธไบ 1 ไธช Broker๏ผๅๆถ๏ผๆๅทฒไป็ไบง็ฏๅขไปฅๅฎๅ จๅช่ฏปๆนๅผๆๅไบๆๆฐๆญปไฟกๆฅๆ๏ผID:
0A000...๏ผ๏ผๅนถๆๅๆ้่ณๅผๅ็ฏๅขrocketmq-dev๏ผๆฐ MsgId:01000...๏ผ๏ผๆจๅฏ็ดๆฅๅจๆฌๅฐๅผๅ็ฏๅขๆญ็น่ฐ่ฏๆถ่ดน้ป่พ๏ผโ
๐ ๅฟซ้ๅผๅงไธๅฎขๆท็ซฏ้ ็ฝฎ (Usage & Configuration)
mcp-server-rocketmq ้็จๅไธ่ช้ๅบๅฏๆง่ก Fat Jar ่ฎพ่ฎก๏ผๅ็ๆฏๆ Stdio ๆจกๅผ๏ผๆฌๅฐ AI ๅฎฟไธปไผด็่ฟ่ก๏ผ ไธ SSE ๆจกๅผ๏ผ่ฟ็จไบๅ็ๅพฎๆๅก่ฟ่ก๏ผใ
1. ๐ฅ ๅฟซ้่ทๅไธๅฎ่ฃ (Download & Pull)
mcp-server-rocketmq ๆฏๆๅค็ง่ทๅไธๅฎ่ฃ
ๅงฟๅฟ๏ผๆ ่ฎบไฝ ๆฏๅฆๅ
ทๅค Java ็ฏๅข๏ผ้ฝ่ฝๆ้ๆฅๅ
ฅ๏ผ
- ๆนๅผไธ๏ผ้่ฟ npm / npx ้ถ้จๆงๅณๆถๅฏๅจ๏ผ๐ฅ ้ฆ้ๆ้ๆจ่๏ผ
้ถ JRE ไพ่ต๏ผๆ ้ๅฎ่ฃ Java ๆ Docker๏ผNode.js ็ฏๅขไธไธ่กๅฝไปคๅณๅผๅณ็จ๏ผๆฏๆ macOS Apple SiliconใLinux x64ใLinux ARM64 ๅ Windows x64๏ผ๏ผnpx -y @atengk/mcp-server-rocketmq --rocketmq.namesrv-addr="127.0.0.1:9876"๐ก ๅฝๅ ๅ ้ๆ็คบ๏ผ่ฅๅจๅฝๅ ็ฝ็ป็ฏๅขไธไธ่ฝฝ npm ๅ ่พๆ ข๏ผๅฏไฝฟ็จ npmmirror ้ๅๆบๅ ้ไธ่ฝฝ๏ผ
# Linux / macOS npm_config_registry=https://registry.npmmirror.com npx -y @atengk/mcp-server-rocketmq --rocketmq.namesrv-addr="127.0.0.1:9876" # Windows PowerShell $env:npm_config_registry="https://registry.npmmirror.com"; npx -y @atengk/mcp-server-rocketmq --rocketmq.namesrv-addr="127.0.0.1:9876" - ๆนๅผไบ๏ผ็ดๆฅไธ่ฝฝ GitHub Releases ็ฌ็ซๅ็ไบ่ฟๅถ๏ผ็ฆป็บฟ่ฑๆบๆ้็งๅผ๏ผ
่ฎฟ้ฎ GitHub Releases ่ทๅ็ป่ฟ GraalVM Native AOT ็ผ่ฏ็ๅๆไปถๅ็ๅฏๆง่ก็จๅบ๏ผๆ ้ไปปไฝๅค้จ่ฟ่กๆถไพ่ต๏ผๅฏๅจไป ้ 50msใๅ ๅญๅ ็จไป 30MB ๅทฆๅณ๏ผmcp-server-rocketmq-1.2.0-linux-x64๏ผLinux x86_64 / glibc๏ผmcp-server-rocketmq-1.2.0-linux-arm64๏ผLinux AArch64 / ARM64 / ้ฒฒ้น / AWS Graviton๏ผmcp-server-rocketmq-1.2.0-win32-x64.exe๏ผWindows x86_64๏ผmcp-server-rocketmq-1.2.0-darwin-arm64๏ผmacOS Apple Silicon M ็ณปๅ๏ผ
- ๆนๅผไธ๏ผไธ่ฝฝ่ทจๅนณๅฐ้็จ Fat Jar๏ผไผ ็ป JVM ็ฏๅข๏ผ
ไป GitHub Releases ไธ่ฝฝmcp-server-rocketmq-1.2.0.jar๏ผ้ๅธฆchecksums.txtๆ ก้ชๅ๏ผ๏ผ็ดๆฅๅบไบๆฌๅฐ JRE 21+ ่ฟ่กใ - ๆนๅผๅ๏ผๆๅๅฎๆนๅคๆถๆ Docker ้ๅ
docker pull ghcr.io/atengk/mcp-server-rocketmq:latest - ๆนๅผไบ๏ผไปๆบ็ ๆฌๅฐ็ผ่ฏๆๅปบ
git clone https://github.com/atengk/mcp-server-rocketmq.git cd mcp-server-rocketmq mvn clean package -DskipTests
2. โ๏ธ ไธ็ปดๅบ็ก้ ็ฝฎๅงฟๅฟ (Usage Modalities)
mcp-server-rocketmq ๅ
ทๅคๅทฅไธ็บง็้
็ฝฎ็ตๆดปๆง๏ผๆฏๆไปฅไธไธ็งๆญฃไบคไฝฟ็จๅฝขๆ๏ผไผๅ
็บง็ฑ้ซๅฐไฝไพๆฌกไธบ๏ผCLI ๅๆฐ > ็ฏๅขๅ้ > ้
็ฝฎๆไปถใ
ๅงฟๅฟไธ๏ผ็ณป็ป็ฏๅขๅ้ๆนๅผ (Environment Variables)
้ๅๅฎนๅจๅ้จ็ฝฒใKubernetes ConfigMap/Secret ๅๅ AI ๅฎขๆท็ซฏ็ env ไธไธๆๆณจๅ
ฅ๏ผ
export MCP_ROCKETMQ_NAMESRV_ADDR="10.0.0.1:9876;10.0.0.2:9876"
export MCP_ROCKETMQ_ENDPOINTS="10.0.0.1:8081"
export MCP_ROCKETMQ_ACCESS_KEY="rocketmq_user"
export MCP_ROCKETMQ_SECRET_KEY="rocketmq_pass"
export MCP_ROCKETMQ_READ_ONLY="false"
export MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS="false"
export MCP_SERVER_PORT="8080"
java -jar mcp-server-rocketmq-1.0.0.jar
ๅงฟๅฟไบ๏ผๅฝไปค่กๅฏๅจๅๆฐๆนๅผ (CLI Arguments)
้ๅ้่ฟ Spring ๅฝๅ้ฃๆ ผๅจๆ่ฆ็ไธชๅซ่ฐ่ฏๅๆฐ๏ผ
java -jar mcp-server-rocketmq-1.0.0.jar \
--rocketmq.namesrv-addr=192.168.1.100:9876 \
--rocketmq.endpoints=192.168.1.100:8081 \
--rocketmq.read-only=true \
--server.port=9090
ๅงฟๅฟไธ๏ผSpring ๅค็ฏๅข้ ็ฝฎๆนๅผ (Multi-Environment Profiles)
้ๅฏนๅผๅใๆต่ฏไธ็ไบง็ญไธๅ็ฝ็ป้็ฆป็ฏๅข๏ผๅฏไธ้ฎๅๆขๅ ็ฝฎ็ Profile ๆจกๆฟ๏ผ
# ๆฟๆดปๅผๅๆต่ฏ็ฏๅข (Profile: dev๏ผ้ป่ฎคๅผๅฏ็ ดๅๆงๅทฅๅ
ทไธๆฌๅฐ่ฟๆฅ)
java -jar mcp-server-rocketmq-1.0.0.jar --spring.profiles.active=dev
# ๆฟๆดป็ไบงๅฎๅ
จ็ฏๅข (Profile: prod๏ผๅผบๅถๅช่ฏปๆจกๅผ๏ผ็กฌ้ๅฎ็ ดๅๆงๅทฅๅ
ท)
java -jar mcp-server-rocketmq-1.0.0.jar --spring.profiles.active=prod
3. ๐ป ๆฌๅฐไผด็ๅฎขๆท็ซฏๆฅๅ ฅ (Stdio ๆจกๅผ)
ๅจ Stdio ๆจกๅผไธ๏ผAI ๅฎฟไธปๅฎขๆท็ซฏ๏ผๅฆ Claude DesktopใAntigravityใCursorใClineใWindsurf ็ญ๏ผไผๅฏๅจๆๅก็ซฏ่ฟ็จไฝไธบๆฌๅฐๅญ่ฟ็จ๏ผๅนถ้่ฟๆ ๅ่พๅ ฅ่พๅบๆตไบคๆข JSON-RPC ๆฅๆใ
3.1 ไฝฟ็จ npx ่ฟ่ก๏ผ๐ฅ ้ฆ้ๆ้ๆจกๅผ๏ผ้ถ Java ไพ่ต๏ผ
ๆ ้้ขๅ
ๅฎ่ฃ
Java ็ฏๅข๏ผไพๆ GraalVM Native AOT ๅ็้ข็ผ่ฏไบ่ฟๅถ๏ผNode.js ็ฏๅขไธ npx ่ชๅจๆๅฝๅๆไฝ็ณป็ปๆถๆ็ง็บง่ฐๅบฆๅน้
็ๅนณๅฐๅ
๏ผ
{
"mcpServers": {
"rocketmq": {
"command": "npx",
"args": [
"-y",
"@atengk/mcp-server-rocketmq"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "127.0.0.1:9876",
"MCP_ROCKETMQ_ENDPOINTS": "127.0.0.1:8081",
"MCP_ROCKETMQ_READ_ONLY": "false",
"MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS": "false"
}
}
}
}
๐ก ่ชๅจๅนณๅฐ่ทฏ็ฑๆบๅถไธๅฝๅ ๅ ้๏ผ
ไธปๅ@atengk/mcp-server-rocketmqไผ่ชๅจ่งฃๆ่ฟ่กๅนณๅฐๅนถ่ฐๅบฆๅฏนๅบ็ๅ็ไบ่ฟๅถ๏ผWindows x64 / Linux x64 / Linux arm64 / macOS arm64๏ผ๏ผไธๅฏๅจๅจๅ ้จไธฅๆ ผ้ตๅพช ADR 0003๏ผ้่ฟ่ก็บงๆบ่ฝๅๆต่ฟๆปคๆ่ดจ๏ผ็กฎไฟstdout้ถๆฑกๆใ
่ฅๅจๅฝๅ ็ฝ็ป็ฏๅขไธๆๅๅ ่พๆ ข๏ผไบฆๅฏๅจ้ ็ฝฎ็envไธญๅฃฐๆ"npm_config_registry": "https://registry.npmmirror.com"ๅ ้ไธ่ฝฝใ
3.2 ไฝฟ็จๅๅนณๅฐๅๆไปถๅ็ไบ่ฟๅถ่ฟ่ก๏ผ่ฑๆบ็ฆป็บฟ๏ผๆ้ๅทๅฏๅจ๏ผ
่ฅไฝ ็ๆบๅจๅคไบๅ ็ฝ็ฆป็บฟ็ฏๅข๏ผไป GitHub Releases ไธ่ฝฝๅๆไปถๅ็ๅฏๆง่ก็จๅบๅ๏ผๅฏ็ดๆฅไฝไธบๅฏๆง่ก็จๅบ้ ็ฝฎ่ฟ่ก๏ผ
{
"mcpServers": {
"rocketmq": {
"command": "/path/to/mcp-server-rocketmq-1.2.0-linux-x64",
"args": [
"--mcp.transport=stdio"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "127.0.0.1:9876",
"MCP_ROCKETMQ_ENDPOINTS": "127.0.0.1:8081"
}
}
}
}
(Windows ็จๆทๅฐ command ๆๅฎไธบ C:\\path\\to\\mcp-server-rocketmq-1.2.0-win32-x64.exe ๅณๅฏ)
3.3 ไฝฟ็จ Java Jar ่ฟ่ก (ๆฌๅฐ JVM ๅฎฟไธป็ฏๅข)
็กฎไฟๆฌๆบๅทฒๅฎ่ฃ JDK 21๏ผๅจ AI Agent ้็จ้ ็ฝฎๆไปถไธญๅขๅ ๏ผ
{
"mcpServers": {
"rocketmq": {
"command": "java",
"args": [
"-jar",
"/path/to/mcp-server-rocketmq-1.2.0.jar",
"--mcp.transport=stdio"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "127.0.0.1:9876",
"MCP_ROCKETMQ_ENDPOINTS": "127.0.0.1:8081",
"MCP_ROCKETMQ_READ_ONLY": "false",
"MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS": "false"
}
}
}
}
๐ก ๆ ๅ่พๅบ็บฏๅๅไฟ้๏ผ ๅฏๅจๅๆฐๅ ๅซ
--mcp.transport=stdioๆถ๏ผๅ ็ฝฎ็ฏๅขๅ็ฝฎๅค็ๅจไผ่ชๅจๅ้ค Web ๅฎนๅจใๅ ณ้ญ Banner ๅนถๅฐๅ จ้จๆฅๅฟ้ๅฎๅ่ณSystem.err๏ผไฟ่ฏSystem.out100% ็บฏๅๆต้ JSON-RPC๏ผๆ็ปๆฅๆ่งฃๆๅดฉๆบ๏ผ่ฏฆ่ง ADR 0003๏ผใ
3.4 ไฝฟ็จ Docker ๅฎนๅจไฝไธบ Stdio ่ฟ่ก (ๅ ๆฌๅฐ Java ็ฏๅข)
{
"mcpServers": {
"rocketmq": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "MCP_ROCKETMQ_NAMESRV_ADDR=host.docker.internal:9876",
"-e", "MCP_ROCKETMQ_ENDPOINTS=host.docker.internal:8081",
"-e", "MCP_ROCKETMQ_READ_ONLY=false",
"-e", "MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS=false",
"ghcr.io/atengk/mcp-server-rocketmq:latest",
"--mcp.transport=stdio"
]
}
}
}
3.3 ไธปๆต AI ๅฎขๆท็ซฏ้ ็ฝฎๆไปถ่ทฏๅพ้ๆฅ
ๅไธปๆต AI ๅฎฟไธปๅฎขๆท็ซฏ็ๆ ๅ้
็ฝฎ่ทฏๅพๅฆไธ๏ผๅฐไธ่ฟฐ้
็ฝฎ่ดดๅ
ฅๆไปถๅฏนๅบ็ mcpServers ่็นๅณๅฏ็ๆ๏ผ
4. ๐ ่ฟ็จๅพฎๆๅกไธๅฎนๅจๅ้จ็ฝฒ (SSE ๆจกๅผ)
ๅฐๆๅก็ซฏ้จ็ฝฒๅจ่ฟ็จๆๅกๅจๆๅฎนๅจๅนณๅฐไธญๅธธ้ฉป่ฟ่ก๏ผๆฏๆๅคๆบ่ฝไฝๆๅข้ๅ ฑไบซๅไธไธช RocketMQ ๆงๅถ้ขใ
4.1 ๆนๅผ A๏ผDocker Compose ไธ้ฎๅฏๅจ (ๆจ่)
ไปๅบๆ น็ฎๅฝๅทฒๅ
็ฝฎ็ไบงๅฐฑ็ปช็ docker-compose.yml ไธ .env.example๏ผ
# 1. ๅคๅถ็ฏๅขๅ้ๆจก็ๅนถๆ้้
็ฝฎ
cp .env.example .env
# 2. ไธ้ฎๅๅฐๅฏๅจๆๅก
docker compose up -d
# 3. ๆฅ้ชๅฎนๅจ่ฟ่กๆฅๅฟ
docker compose logs -f
4.2 ๆนๅผ B๏ผDocker ๅ็่ฟ่ก
docker run -d \
--name mcp-server-rocketmq \
-p 8080:8080 \
-e MCP_ROCKETMQ_NAMESRV_ADDR="192.168.1.100:9876" \
-e MCP_ROCKETMQ_ENDPOINTS="192.168.1.100:8081" \
-e MCP_ROCKETMQ_READ_ONLY="false" \
ghcr.io/atengk/mcp-server-rocketmq:latest
4.3 ๆนๅผ C๏ผๅฏๆง่ก Jar ่ฟ่ก
java -jar mcp-server-rocketmq-1.0.0.jar \
--server.port=8080 \
--rocketmq.namesrv-addr=192.168.1.100:9876 \
--rocketmq.endpoints=192.168.1.100:8081 \
--rocketmq.read-only=false
4.4 AI Agent ๅฎขๆท็ซฏๆฅๅ ฅ (SSE URL)
ๅจๆฏๆ่ฟ็จ URL ่ฟๆฅ็ AI Agent ๅฎขๆท็ซฏไธญ้ ็ฝฎ๏ผ
{
"mcpServers": {
"rocketmq": {
"url": "http://your-server-ip:8080/mcp/sse"
}
}
}
- SSE ๅปบ็ซ่ฟๆฅ็ซฏ็น๏ผ
http://your-server-ip:8080/mcp/sse - ๆถๆฏๅ้ไบคไบ็ซฏ็น๏ผ
http://your-server-ip:8080/mcp/message
5. ๐ ไผไธ็บงๅค็ฏๅขไธๅค้็พค MCP ๅๅๅฎ่ทต (Multi-Environment Setup)
ๅจ็ๅฎไผไธ็ ๅ่ฟ็ปดไธญ๏ผๆๆจ่็ๅฎ่ทตๆฏๅจๅไธไธช AI Agent ๅฎขๆท็ซฏไธญๅๆถๅนถๅๆ่ฝฝๅคไธช็ฏๅข็ RocketMQ ๆๅก็ซฏ่ฟๆฅ๏ผๅฆ rocketmq-devใrocketmq-testใrocketmq-prod๏ผ๏ผๅนถ้่ฟๅ็บงๅฎๅ
จๅฎๅซๅฎๆฝไธฅๆ ผ็ๆ้็ฎกๆงใ
5.1 ๅค็ฏๅขๅ็บงๅฎๅ จๆจ่็ฉ้ต
5.2 ๆฌๅฐ Stdio ๆจกๅผๅค็ฏๅข้ ็ฝฎ็คบไพ
ๅจ AI ๅฎขๆท็ซฏ้็จ้ ็ฝฎๆไปถไธญ๏ผๅนถๅๅฃฐๆๅคไธชๆๅกๅฎไพ๏ผ
{
"mcpServers": {
"rocketmq-dev": {
"command": "java",
"args": [
"-jar", "/path/to/mcp-server-rocketmq-1.0.0.jar",
"--mcp.transport=stdio",
"--spring.ai.mcp.server.name=rocketmq-dev"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "127.0.0.1:9876",
"MCP_ROCKETMQ_ENDPOINTS": "127.0.0.1:8081",
"MCP_ROCKETMQ_READ_ONLY": "false",
"MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS": "true"
}
},
"rocketmq-test": {
"command": "java",
"args": [
"-jar", "/path/to/mcp-server-rocketmq-1.0.0.jar",
"--mcp.transport=stdio",
"--spring.ai.mcp.server.name=rocketmq-test"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "192.168.10.20:9876",
"MCP_ROCKETMQ_ENDPOINTS": "192.168.10.20:8081",
"MCP_ROCKETMQ_READ_ONLY": "false",
"MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS": "false"
}
},
"rocketmq-prod": {
"command": "java",
"args": [
"-jar", "/path/to/mcp-server-rocketmq-1.0.0.jar",
"--mcp.transport=stdio",
"--spring.ai.mcp.server.name=rocketmq-prod"
],
"env": {
"MCP_ROCKETMQ_NAMESRV_ADDR": "10.0.100.1:9876;10.0.100.2:9876",
"MCP_ROCKETMQ_ENDPOINTS": "10.0.100.1:8081",
"MCP_ROCKETMQ_ACCESS_KEY": "prod_access_key",
"MCP_ROCKETMQ_SECRET_KEY": "prod_secret_key",
"MCP_ROCKETMQ_READ_ONLY": "true",
"MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS": "false"
}
}
}
}
5.3 ่ฟ็จ SSE ๆจกๅผๅค็ฏๅขๆฅๅ ฅ็คบไพ
่ฅๆๅก็ซฏไปฅๅฎนๅจๅพฎๆๅกๅฝขๆ่ฟ่กไบๅ็ฝ็ป้็พคๅ ้จ๏ผๅฎขๆท็ซฏๅช้้ ็ฝฎๅ็ฏๅขๅฏนๅบ URL๏ผ
{
"mcpServers": {
"rocketmq-dev": {
"url": "http://rocketmq-mcp-dev.internal:8080/mcp/sse"
},
"rocketmq-test": {
"url": "http://rocketmq-mcp-test.internal:8080/mcp/sse"
},
"rocketmq-prod": {
"url": "https://rocketmq-mcp-prod.internal:8443/mcp/sse"
}
}
}
โ๏ธ ๅฎๆด็ฏๅขๅ้ไธๅๆฐๆธ ๅ
ไผๅ
่ฏปๅๆ ๅ MCP_ROCKETMQ_* ๅ็ผ็ฏๅขๅ้๏ผๅๆถๅนณๆปๅ
ผๅฎนๆ ๅ็ผๅฝขๅผ๏ผ
โ ๅธธ่ง้ฎ้ขไธๆ้ๆๅ (FAQ)
Q1: ๅจ AI Agent ๅฎฟไธปไธญไฝฟ็จ Stdio ๆจกๅผๆฅ้ JSON-RPC parse error๏ผ
- ๅๅ ๏ผSpring Boot ๅฏๅจๆฅๅฟใASCII Banner ๆ็ฌฌไธๆน็ปไปถ็่ฐ่ฏไฟกๆฏๆททๅ
ฅๅฐไบๆ ๅ่พๅบ
System.outไธญใ - ่งฃๅณๅๆณ๏ผ
- ็กฎไฟๅฏๅจๅๆฐไธญๅ
ๅซ
--mcp.transport=stdio๏ผ้กน็ฎๅ ็ฝฎ็็ฏๅขๅค็ๅจไผ่ชๅจๅ ณ้ญ Banner ๅนถๅฐๅ จ้จ Logback ๆฅๅฟๅฎๅ่ณSystem.err๏ผ - ไธฅ็ฆๅจไธๅกไธญ่ฐ็จ
System.out.println๏ผไปฃ็ ็ปไธไฝฟ็จ SLF4J ่ฎฐๅฝๆฅๅฟใ
- ็กฎไฟๅฏๅจๅๆฐไธญๅ
ๅซ
Q2: ไฝฟ็จ Docker ่ฟ่กๆถ๏ผๆฅ้ๆ ๆณ่ฟๆฅ NameServer (127.0.0.1:9876)๏ผ
- ๅๅ ๏ผๅฎนๅจๅ
็
127.0.0.1ๆๅๅฎนๅจ่ช่บซ็ฏๅข๏ผ่้ๅฎฟไธปๆบใ - ่งฃๅณๅๆณ๏ผ
- ๅฆๆ RocketMQ ้จ็ฝฒๅจๅฎฟไธปๆบ๏ผ่ฏทๅฐ็ฏๅขๅ้้
็ฝฎไธบ
MCP_ROCKETMQ_NAMESRV_ADDR=host.docker.internal:9876๏ผ - ๆจ่็ดๆฅไฝฟ็จ้กน็ฎๆไพ็
docker-compose.yml๏ผๅทฒ้ป่ฎค้ข่ฎพextra_hostsๅฎฟไธปๆบ็ฝๅ ณๆ ๅฐใ
- ๅฆๆ RocketMQ ้จ็ฝฒๅจๅฎฟไธปๆบ๏ผ่ฏทๅฐ็ฏๅขๅ้้
็ฝฎไธบ
Q3: ไธบไปไน่ฐ็จ rocketmq_delete_topic ๆ rocketmq_reset_consumer_offset ๆ็คบๆ้่ขซๆฆๆชๆ็ป๏ผ
- ๅๅ ๏ผ่งฆๅไบ็ณป็ป็ๅๅฑ้ฒๅๅฎๅ จๆบๅถ๏ผ่ฏฆ่ง ADR 0002๏ผใ
- ่งฃๅณๅๆณ๏ผ
- ๆๅก็ซฏๅฏๅจ็ฏๅขๅ้ๅฟ
้กปๆพๅผ้
็ฝฎ
MCP_ROCKETMQ_ENABLE_DESTRUCTIVE_TOOLS=true๏ผ - AI ๅฎฟไธปๅจ่ฐ็จ่ฏฅๅทฅๅ
ทๆถ๏ผๅ
ฅๅไธญๅฟ
้กปๆพๅผไผ ้
confirm: trueๅๆฐใ
- ๆๅก็ซฏๅฏๅจ็ฏๅขๅ้ๅฟ
้กปๆพๅผ้
็ฝฎ
Q4: ๆ็้็พคๆฏ RocketMQ 4.x๏ผๆฒกๆ gRPC Proxy๏ผ๏ผ่ฝไฝฟ็จๆฌ้กน็ฎๅ๏ผ
- ่งฃ็ญ๏ผๅฎๅ
จๅฏไปฅไฝฟ็จ็ปๅคง้จๅๅ่ฝ๏ผ
- ้็พคๆๆใBroker ๆๆ ใTopic ๅขๅ ๆนๆฅใๆถ่ดน็ป็ถๆๅฎก่ฎกใๅฎๆถ Lag ็งฏๅๆๆฅใไฝ็น้็ฝฎไปฅๅๆญปไฟกๆฃ็ดข็ญ 17 ้กน่ฟ็ปด็ฎก็ไธๆ้ๅทฅๅ ทๅๅบไบ Remoting ๅ่ฎฎ๏ผๅ็ๅฎ็พๅไธๅ ผๅฎน 4.x๏ผ
- ไป
ๆ
rocketmq_send_messageๆต่ฏๅ้ๅทฅๅ ทไพ่ต 5.x gRPC Proxyใ
Q5: ่ทจ็ฝ็ปๆๅฎนๅจ้จ็ฝฒ่ฟๆฅ RocketMQ ๆฅ้่ฟๆฅ่ถ ๆถๆ็ฝ็ปไธ้๏ผ
- ๅๅ ๏ผRocketMQ ้็จไธค้ถๆฎต่ทฏ็ฑ้ไฟกๆจกๅใๅฎขๆท็ซฏๅ
่ฟๆฅ NameServer (
9876) ่ทๅ่ทฏ็ฑๅ ๆฐๆฎ๏ผ้ๅ็ฑ NameServer ่ฟๅ Broker ่็น็ๆณจๅ IP/็ซฏๅฃๅนถ็ด่ฟ Broker๏ผgRPC ๅ่ฟๆฅ Proxy (8081)ใๅฆๆไฝไบไธๅ็ฝ็ปใๅฎนๅจๆไบๅฎๅ จ็ปไธญ๏ผไป ๆพ้ NameServer ๆ ๆณๅฎๆๅ็ปญๆฐๆฎ้ไฟกใ - ๆๆฅไธ่งฃๅณๅๆณ๏ผ
- ๆพ้ๆ ธๅฟๆๅก็ซฏๅฃ๏ผ
9876: NameServer ๆๅก็ซฏๅฃ๏ผRemoting ่ทฏ็ฑๅฏปๅ๏ผๅฟ ้กป้๏ผ๏ผ8081: RocketMQ 5.x Proxy ๆๅก็ซฏๅฃ๏ผgRPC ๆถๆฏไบคไบ๏ผๆต่ฏๅไฟก้่ฆ๏ผ๏ผ10911/10909: Broker ้ป่ฎค Remoting ็ๅฌ็ซฏๅฃไธ VIP ็ซฏๅฃ๏ผๅฟ ้กปไธๅฎขๆท็ซฏไบ้๏ผ๏ผ
- Broker ๅนฟๆญๅฐๅ (brokerIP1)๏ผ
- ่ฅ Broker ่ฟ่กๅจ Docker ๅฎนๅจๆไบ็งๆ็ฝ็ปไธญ๏ผBroker ไผ้ป่ฎคๅฐๅฎนๅจๅ
็ฝ IP ๆณจๅ็ป NameServer๏ผๅฏผ่ดๅค้จๅฎขๆท็ซฏๆฟๅฐ็ๅฐๅๆ ๆณ่ฎฟ้ฎใ่ฏทๅจ Broker ้
็ฝฎๆไปถ๏ผ
broker.conf๏ผไธญๆพๅผ้ ็ฝฎbrokerIP1=<ๅฎฟไธปๆบๅ ฌ็ฝๆๅฏ่พพๅ ็ฝIP>ใ
- ่ฅ Broker ่ฟ่กๅจ Docker ๅฎนๅจๆไบ็งๆ็ฝ็ปไธญ๏ผBroker ไผ้ป่ฎคๅฐๅฎนๅจๅ
็ฝ IP ๆณจๅ็ป NameServer๏ผๅฏผ่ดๅค้จๅฎขๆท็ซฏๆฟๅฐ็ๅฐๅๆ ๆณ่ฎฟ้ฎใ่ฏทๅจ Broker ้
็ฝฎๆไปถ๏ผ
- ๆพ้ๆ ธๅฟๆๅก็ซฏๅฃ๏ผ
๐ ๅทฅ็จ็ฎๅฝ็ปๆไธๆถๆๅณ็ญ (ADRs)
.
โโโ .github/
โ โโโ workflows/
โ โ โโโ ci.yml # ่ชๅจๅ่ดจ้้จ็ฆๆตๆฐด็บฟ (JDK 21 + mvn verify)
โ โ โโโ release.yml # ๅ่ฝจ็ฒพๅ่ชๅจๅๅ็ๆตๆฐด็บฟ (Fat Jar / GHCR)
โ โโโ ISSUE_TEMPLATE/ # ็ปๆๅ Issue ๅ้ฆๆจก็
โ โโโ PULL_REQUEST_TEMPLATE.md # PR ๆไบคๅฎกๆ ธๆจก็
โโโ docs/
โ โโโ adr/ # ๆ ธๅฟๆถๆๅณ็ญ่ฎฐๅฝ (ADR 0001 ~ 0010)
โ โ โโโ 0001-hybrid-client-architecture.md
โ โ โโโ 0002-dual-layer-safety-guard.md
โ โ โโโ 0003-single-jar-dual-mode-transport.md
โ โ โโโ 0004-mcp-full-specification-and-body-truncation.md
โ โ โโโ 0005-dependency-matrix-and-runtime-baseline.md
โ โ โโโ 0006-containerization-and-release-pipeline.md
โ โ โโโ 0007-package-namespace-and-maven-coordinates.md
โ โ โโโ 0008-client-lifecycle-hardening-and-resilience.md
โ โ โโโ 0009-graalvm-native-and-npm-distribution.md
โ โ โโโ 0010-four-platform-native-matrix-and-asset-naming.md
โ โโโ agents/ # ๆบ่ฝไฝๅทฅ็จๅไฝ่ง่ (Issue/Triage/Domain)
โโโ Dockerfile # Temurin JRE 21 Alpine ๅค้ถๆฎตๆๅปบ้ๅ
โโโ docker-compose.yml # ๅฎนๅจ็ผๆไธ้ฎๅฏๅจๆจก็
โโโ .env.example # ็ฏๅขๅ้้
็ฝฎ็คบไพ
โโโ AGENTS.md # ๆบ่ฝไฝ่กไธบไธๆ่ฝๅๅ
โโโ CONTEXT.md # ้ขๅๆ ธๅฟๆฏ่ฏญ่กจไธ็ปไธ่ฏญ่จ
โโโ CONTRIBUTING.md # ่ดก็ฎๆๅไธ Commit ่ง่
โโโ pom.xml # Maven ๆ ธๅฟ้
็ฝฎ (io.github.atengk)
โโโ README.md # ้กน็ฎไธปๆๆกฃ
๐ ๏ธ ๆฌๅฐๆๅปบ
# ็กฎไฟๆฌๅฐๅทฒๅฎ่ฃ
JDK 21 ไธ Maven 3.9+
mvn clean package -DskipTests
๐ค ๅไธ่ดก็ฎ
็ญ็ๆฌข่ฟๆไบค Issueใๅ่ตท Pull Request ๆๅฏนๅ่ฝ่งๅๆๅบๅปบ่ฎฎ๏ผๅจๆไบคไปฃ็ ๅ๏ผ่ฏทไป็ปๆฅ้ ๆไปฌ็ ่ดก็ฎๆๅ (CONTRIBUTING.md)ใ
๐ ๅผๆบ่ฎธๅฏ่ฏ
ๆฌ้กน็ฎๅบไบ Apache License 2.0 ๅ่ฎฎๅผๆบใ