AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Java Agent Study

mcp-zeroaihub-java-agent-study · by zeroaihub

从 Java 开发者到 AI Agent 工程师的 30 天实战之路 | Spring Boot + Spring AI + MCP + Multi-Agent

↗ Repository
— No reviews yet
0 installs
23 views
0.0% view→install

Install

$ agentstack add mcp-zeroaihub-java-agent-study

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-zeroaihub-java-agent-study)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 1mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Java Agent Study? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Java Agent Study

从 Java 开发者到 AI Agent 工程师的 30 天实战之路

一个面向企业级落地的 AI Agent 系统学习项目，涵盖 LLM API、Function Calling、Memory、RAG、Workflow、MCP、Multi-Agent 等核心能力，最终构建完整的 ZeroHub AI Agent Platform。

项目简介

本项目是一个 Java 开发者系统转型 AI Agent 工程师 的完整学习路线与实战源码集合。

> 目标不是研究大模型算法，而是成为能够独立设计、开发、部署和商业化 AI Agent 的高级工程师。

每一天的学习都以 独立模块 形式存在，可独立运行、独立理解，最终汇聚为一个可商业化的 AI Agent 平台。

最终目标

  • AI Agent 架构师
  • 开发自己的 AI SaaS
  • 建立自己的 AI Agent 平台
  • 接企业 AI 项目
  • 创业

技术栈

| 类别 | 技术 | |------|------| | 语言 | Java 21 | | 框架 | Spring Boot 4.1.0 / Spring AI 2.0.0 | | AI 框架 | Spring AI / LangChain4j | | 构建工具 | Maven | | 数据库 | PostgreSQL + pgvector | | 缓存 | Redis | | 容器化 | Docker | | 浏览器自动化 | Playwright | | 协议 | MCP (Model Context Protocol) | | LLM 接口 | OpenAI Compatible API (LM Studio / DeepSeek / 通义等) | | 辅助语言 | Python（仅用于阅读开源项目） |

项目结构

Java-Agent-Study/
├── src/main/java/com/zero/ai/agentstudy/
│   ├── day01foundation/       # Day1  - AI基础 & 第一个LLM Demo
│   ├── day02llmapi/           # Day2  - LLM API & 企业级Chat服务
│   ├── day3funcall/           # Day3  - Function Calling & Tool Calling
│   ├── day4memory/            # Day4  - Memory & 会话管理
│   ├── day05rag/              # Day5  - RAG & 企业知识库
│   ├── day06workflow/         # Day6  - Workflow Engine
│   ├── day07mcp/              # Day7  - MCP协议
│   ├── day08multiagent/       # Day8  - Multi-Agent协作
│   ├── day09browseragent/     # Day9  - Browser Agent & 浏览器自动化
│   ├── day10planningagent/    # Day10 - Planning Agent & 自主规划
│   ├── back/                  # 早期实验代码（API原理/流式/结构化输出）
│   └── AgentStudyApplication.java
├── src/main/resources/
│   ├── application.yml        # 统一配置
│   └── static/                # 前端演示页面
├── pom.xml
└── README.md

每个 Day 模块内部结构：

dayXX/
├── controller/     # API 入口
├── service/        # 业务逻辑
├── config/         # 配置类
├── dto/            # 数据传输对象
├── entity/         # 实体
├── tool/           # Agent 工具
└── docs/           # 学习文档
    ├── README.md
    ├── ARCHITECTURE.md
    ├── TODO.md
    └── chapters/   # 逐章学习记录

学习路线（30 天）

已完成

| Day | 主题 | 核心内容 | 状态 | |-----|------|----------|------| | 01 | Foundation | AI发展、LLM原理、Java AI环境、第一个LLM Demo | ✅ | | 02 | LLM API | Chat Completion、Streaming、Spring AI、企业级Chat服务 | ✅ | | 03 | Function Calling | Tool Calling、Java Tool注册、Agent调用工具 | ✅ | | 04 | Memory | Chat Memory、Long Memory、Session、User Profile、Memory Agent | ✅ | | 05 | RAG | Embedding、Chunk、Vector Store、Retriever、企业知识库 | ✅ | | 06 | Workflow | Workflow Engine、Node、Context、Executor、企业Workflow | ✅ | | 07 | MCP | MCP Client/Server、Protocol、Tool Registry、Workflow + MCP | ✅ | | 08 | Multi-Agent | Coordinator、Planner、Research/Writer/Reviewer Agent、共享Memory | ✅ | | 09 | Browser Agent | Playwright、网页自动操作、浏览器Tool | ✅ | | 10 | Planning Agent | Goal拆解、DAG调度、Reflection、Self-Correction、自主规划引擎 | ✅ |

进行中 / 规划中

| Day | 主题 | 核心内容 | 状态 | |-----|------|----------|------| | 11 | Human-in-the-loop | 人工审批、Agent中断恢复 | 🔲 | | 12 | Long Running Agent | 事件驱动、状态恢复 | 🔲 | | 13 | AI Office Agent | 办公自动化 | 🔲 | | 14 | AI WeChat Agent | 微信机器人 | 🔲 | | 15 | AI Knowledge Platform | 知识平台 | 🔲 | | 16 | 企业知识库 V2 | 知识库Agent进阶 | 🔲 | | 17 | Code Agent | 代码生成与执行 | 🔲 | | 18 | AI IDE | 智能开发环境 | 🔲 | | 19 | SQL Agent | 自然语言转SQL | 🔲 | | 20 | Data Analysis Agent | 数据分析 | 🔲 | | 21 | AI Customer Service | 智能客服 | 🔲 | | 22 | AI Search Agent | 智能搜索 | 🔲 | | 23 | Agent Memory Optimization | 记忆优化 | 🔲 | | 24 | Multi-Modal Agent | 多模态 | 🔲 | | 25 | Agent Observability | 可观测性 | 🔲 | | 26 | Agent Security | 安全 | 🔲 | | 27 | Agent Gateway | 网关 | 🔲 | | 28 | Docker + K8s | 容器化部署 | 🔲 | | 29 | AI Trading Agent | Binance + Freqtrade | 🔲 | | 30 | ZeroHub Platform | 最终平台整合 | 🔲 |

快速开始

环境要求

  • JDK 21+
  • Maven 3.9+
  • LM Studio（本地模型推理）或任意 OpenAI 兼容 API 服务

1. 克隆项目

git clone git@github.com:your-username/Java-Agent-Study.git
cd Java-Agent-Study

2. 配置模型服务

编辑 src/main/resources/application.yml：

ai:
  provider:
    base-url: http://127.0.0.1:1234   # LM Studio 或你的 API 地址
    api-key: sk-1234                   # 本地模型可随意填写
    model: your-model-name             # 替换为你加载的模型

3. 启动项目

mvn spring-boot:run

4. 访问接口

项目启动后访问 http://localhost:8080，各模块 API 路径见对应模块文档。

前端演示页面：

  • 聊天界面：http://localhost:8080/chat.html
  • 流式输出：http://localhost:8080/stream.html

模块说明

Day01 - Foundation（AI 基础）

AI 发展史、LLM 核心概念、Java AI 开发环境搭建、使用 Spring AI ChatClient 完成第一个 LLM 对话 Demo。

Day02 - LLM API（大模型接口）

深入 Chat Completion API 协议，实现流式输出（SSE）、多轮对话、Token 计费、结构化输出，构建企业级 Chat 服务。

Day03 - Function Calling（工具调用）

实现 LLM 自主调用 Java 方法：Tool 注册中心、参数解析、执行引擎、Assistant 多轮工具调用循环。

Day04 - Memory（记忆系统）

8 个章节渐进式实现：基础对话记忆 → 滑动窗口 → Token 截断 → 摘要压缩 → 长期记忆 → 用户画像 → 记忆检索 → 完整 Memory Agent。

Day05 - RAG（检索增强生成）

从零实现 RAG 全链路：文档分块 → Embedding 向量化 → 向量存储 → 相似度检索 → Prompt 注入 → LLM 生成，构建企业知识库问答。

Day06 - Workflow（工作流引擎）

设计并实现 Agent Workflow 引擎：节点抽象、上下文传递、条件分支、并行执行、工具节点集成。

Day07 - MCP（模型上下文协议）

实现 MCP Client/Server 通信协议、Tool Registry 动态注册、Workflow 与 MCP 联动，支持跨进程工具调用。

Day08 - Multi-Agent（多智能体协作）

构建 Coordinator 调度器 + Planner 规划器 + 多专职 Agent（Research / Writer / Reviewer），实现共享 Memory 与 Workflow + MCP + Multi-Agent 联合编排。

Day09 - Browser Agent（浏览器智能体）

基于 Playwright 实现浏览器自动化：BrowserSession 会话管理、ContextPool 连接池、PlaywrightEngine 执行引擎、BrowserTools 工具集，让 Agent 能操作真实网页完成信息提取与自动操作。

Day10 - Planning Agent（规划智能体）

Agent 从「被驱动」走向「自主」的分水岭。实现完整 Planning Engine：Goal 目标建模 → LlmPlanner 动态规划 → DagScheduler 依赖调度 → StepExecutor 逐步执行 → ToolSelector 工具选择 → Reflector 反思与自我修正 → PlanningContext 状态管理，构建企业级自主规划引擎。

学习文档

每个模块的 docs/ 目录下包含完整学习文档：

  • README.md — 完整教程（5000+ 字），可脱离聊天记录独立学习
  • ARCHITECTURE.md — 系统架构图、流程图、模块说明、设计决策
  • TODO.md — 必做练习 / 进阶挑战 / 企业级挑战
  • chapters/ — 逐章节 Markdown 学习记录

设计理念

  • Java First — 所有核心实现均为 Java / Spring Boot，Python 仅辅助阅读
  • 企业级 — 不是玩具 Demo，而是面向生产环境的工程实践
  • 渐进式 — 每天一个独立模块，由浅入深，前后衔接
  • 可运行 — 所有代码均可独立编译运行，即学即用
  • 商业化导向 — 最终目标是构建可落地的 AI Agent 平台

适合人群

  • 有 Java / Spring Boot 经验，想转型 AI Agent 方向的开发者
  • 想系统学习 AI Agent 工程化落地的后端工程师
  • 对 AI Agent 架构设计感兴趣的技术负责人
  • 希望构建自己 AI SaaS / Agent 平台的创业者

许可证

[MIT License](LICENSE)

如果这个项目对你有帮助，请给一个 Star ⭐

Built with Java, Spring Boot & Spring AI

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in AI & ML