# math_mcp_server

**Repository Path**: zxl1220/math_mcp_server

## Basic Information

- **Project Name**: math_mcp_server
- **Description**: 基于 Spring Boot 3.5、Spring AI 1.1 的 Streamable HTTP MCP 示例，已实现 WorkBuddy 所需的 OAuth 2.1、PKCE、动态客户端注册和刷新令牌流程。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-29
- **Last Updated**: 2026-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Math MCP Server

基于 Spring Boot 3.5、Spring AI 1.1 的 Streamable HTTP MCP 示例，已实现 WorkBuddy 所需的 OAuth 2.1、PKCE、动态客户端注册和刷新令牌流程。

## 模块

```text
mcp-server/              MCP 资源服务器与数学工具（8080）
authorization-server/    OAuth 授权服务器（9000）
workbuddy-connector/     WorkBuddy 连接器包
docs/                    开发与接入文档
```

数学工具包括 `addNumbers`、`subtractNumbers`、`multiplyNumbers`、`divideNumbers`。

## 构建与测试

要求 JDK 21：

```powershell
$env:JAVA_HOME = 'D:\Program Files\Java\jdk-21'
.\mvnw.cmd clean package
```

## 本地启动

先启动授权服务器：

```powershell
java -jar .\authorization-server\target\math-mcp-authorization-server-0.0.1-SNAPSHOT.jar
```

再启动 MCP 服务：

```powershell
java -jar .\mcp-server\target\math-mcp-server-0.0.1-SNAPSHOT.jar
```

默认开发账号为 `workbuddy / change-me-before-production`。生产环境必须通过环境变量替换账号、密码、外部 HTTPS URI 和持久化 RSA 签名密钥。

## 文档

- [Spring Boot MCP 开发与 Apifox 测试](docs/SpringBoot-MCP开发文档.md)
- [WorkBuddy MCP OAuth 接入](docs/WorkBuddy-MCP-OAuth接入.md)

MCP 地址为 `http://localhost:8080/api/v1/mcp`。接入 WorkBuddy 时，请使用 `workbuddy-connector/` 并将其中的示例域名替换为真实 HTTPS 域名；不要配置 `auth_mode` 或静态 Token。