Solesonic MCP Server

一个由Spring AI驱动的Spring Boot HTTP MCP（模型上下文协议）服务器。作为OAuth2资源服务器（JWT）进行安全保护，具有基于组和范围的授权、内置的Jira工具以及与外部Atlassian Token Broker集成的功能。

功能

• 🔗 HTTP MCP端点 — 在POST /mcp上通过HTTP进行JSON-RPC通信
• 🧰 内置Jira工具 — 创建问题、分配任务并查找分配人；注意：包括一个简单的示例工具weather_lookup
• 🔐 OAuth2资源服务器（JWT） — JWT验证；组声明映射到权限
• 🔏 MCP授权及动态客户端注册 — 详情见授权
• 👥 组及范围授权 — groups → GROUP_<name> roles → ROLE_<role> 权限；范围 → SCOPE_<scope>
• ⚡ Atlassian Token Broker — 客户端凭证集成以获取短期Atlassian访问令牌
• 🛡️ 生产SSL准备 — 通过ssl配置文件使用PKCS12密钥库；TLS 1.2/1.3

快速开始

先决条件

• Java 25+
• Maven 3.9+
• Docker（可选，用于生产环境运行）

1) 配置环境

注意：操作系统环境变量优先于.env文件中的设置。

# JWT验证（根据您的IdP选择以下之一）
JWK_SET_URI=https://your-issuer/.well-known/jwks.json
# 或
ISSUER_URI=https://your-issuer

# Jira工具
JIRA_URL_TEMPLATE=https://your-domain.atlassian.net/browse/{key}
ATLASSIAN_TOKEN_BROKER_URL=https://your-token-broker.example.com/broker/atlassian/token
ATLASSIAN_TOKEN_BROKER_ISSUER_URI=https://your-authz-server/oauth2/token
ATLASSIAN_TOKEN_BROKER_CLIENT_ID=your-client-id
ATLASSIAN_TOKEN_BROKER_CLIENT_SECRET=your-client-secret
JIRA_CLOUD_ID_PATH=/path/to/your/cloud-id

注意：操作系统环境变量优先于.env文件中的设置。

2) 构建和运行（本地）

# 构建
./mvnw clean verify

# 运行（默认配置文件）
./mvnw spring-boot:run

• 基础URL：https://localhost:9443（当`ssl`配置文件激活时）；否则http://localhost:9443
• MCP端点：POST /mcp

提示：要启用本地HTTPS，请使用配置文件prod,ssl运行： ./mvnw spring-boot:run -Dspring-boot.run.profiles=prod,ssl

3) 验证设置

发送MCP初始化请求（替换占位符）：

curl -k \
  -H "Authorization: Bearer <YOUR_JWT_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -X POST https://localhost:9443/mcp \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {"protocolVersion": "2024-11-05", "client": {"name": "curl", "version": "1.0"}}
  }'

为了获得更丰富的客户端体验，请参阅客户端，了解MCP Inspector和Claude Desktop示例。

MCP服务器及Token Broker

• 该服务器通过MCP协议暴露工具。工具调用使用JWT范围和/或组权限进行授权。
• Jira工具是核心功能。它们依赖于外部Atlassian Token Broker从安全存储的刷新令牌中生成短期访问令牌。

参见：

• 端点
• 工具
• 安全性
• 配置

文档

• 从这里开始：文档
• 深入了解：配置，安全性，端点，工具，部署，故障排除

---

准备好使用MCP构建了吗？请参阅快速开始。