# spring-ai-mcp

**Repository Path**: xiaothu/spring-ai-mcp

## Basic Information

- **Project Name**: spring-ai-mcp
- **Description**: 基于spring的mcp解决方案
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spring-ai-mcp

data genetator enhanced by AI

编译指令：mvn clean install -DskipTests
启动命令：mvn spring-boot:run 2>&1 | tail -50

---

## Token 优化模式（MCP Tool Proxy）

MCP Server 仅对外暴露三个代理工具，实现按需加载工具 schema，将每次对话的预加载 token 大幅降低。

### Token 节省效果

| 场景 | 优化前 | 优化后 | 节省 |
|------|--------|--------|------|
| 预加载（67工具） | ~20,000 tok | ~200 tok | 99% |
| 预加载（200工具） | ~60,000 tok | ~200 tok | 99% |
| 造数对话（含工具调用） | ~20,000 tok | ~2,000 tok | 90% |

### AI 调用三步流程

```
Step 1: list_tools()
  → 返回所有工具名称+描述，约 1,400 tokens
  → AI 从列表中识别所需工具

Step 2: get_tool_schema("工具名")
  → 返回该工具的完整参数定义（JSON Schema）
  → AI 了解参数结构

Step 3: call_tool("工具名", "{...}")
  → 按参数结构执行工具
  → 返回执行结果
```

### 架构说明

- `ToolProxyService` — 三个代理工具的实现（MCP 直接暴露）
- `ToolRegistry` — 启动时扫描所有 `@Tool` 方法，构建内部工具索引并路由调用
- 所有现有业务工具代码**零改动**，由 `ToolRegistry` 透明路由