Java开发者AI编程常用MCP、Skills、Rules全景汇总

Java开发者AI编程常用MCP、Skills、Rules全景汇总

一、MCP服务器清单(按类别分类)

1.1 数据库类MCP

MCP服务器 用途 安装命令/方式 适用场景
PostgreSQL 连接PostgreSQL数据库,支持查询、模式查看 npx @modelcontextprotocol/server-postgres postgresql://localhost/mydb 数据库查询、SQL优化、数据分析
MySQL 连接MySQL数据库 使用@modelcontextprotocol/server-postgres或Docker方式 MySQL数据库操作
Redis Redis缓存操作 docker run mcp/redis 缓存查看、性能调优
Elasticsearch ES搜索和数据分析 docker run -e ES_URL -e ES_API_KEY docker.elastic.co/mcp/elasticsearch stdio 日志分析、全文搜索
MongoDB MongoDB文档数据库操作 npx @modelcontextprotocol/server-mongodb 文档查询、聚合管道
SQL Server 微软SQL Server连接 npx @modelcontextprotocol/server-mssql .NET生态Java项目

PostgreSQL MCP配置示例

json 复制代码
// .vscode/mcp.json 或 Claude Code配置
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", 
               "postgresql://user:password@localhost:5432/mydb"]
    }
  }
}

1.2 版本控制与代码管理类MCP

MCP服务器 用途 安装方式
GitHub PR管理、Issue操作、代码审查 npx @modelcontextprotocol/server-github
GitLab GitLab仓库管理 npx @modelcontextprotocol/server-gitlab
Git 本地Git操作 npx @modelcontextprotocol/server-git

GitHub MCP配置

json 复制代码
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"
      }
    }
  }
}

1.3 DevOps与基础设施类MCP

MCP服务器 用途 安装方式
Docker 容器管理、镜像构建 npx @modelcontextprotocol/server-docker
Kubernetes K8s集群管理、Pod/Deployment操作 npx @modelcontextprotocol/server-kubernetes
Terraform 基础设施即代码管理 自定义MCP或社区实现
Prometheus 监控数据查询、告警查看 docker run mcp/prometheus
Grafana 仪表板查看、数据源管理 npx @modelcontextprotocol/server-grafana
Jenkins CI/CD流水线管理 自定义MCP实现

1.4 开发工具类MCP

MCP服务器 用途 安装方式
Context7 实时获取第三方库文档(React、Next.js、Prisma等10000+库) npx @upstash/context7-mcp
Swagger/OpenAPI API文档解析、接口定义导入 npx @modelcontextprotocol/server-openapi
JSON Schema JSON数据验证、Schema生成 社区实现
PlantUML UML图生成、架构图绘制 npx @modelcontextprotocol/server-plantuml
Mermaid 流程图、时序图生成 npx @modelcontextprotocol/server-mermaid

1.5 搜索与内容类MCP

MCP服务器 用途 安装方式
Web Search 互联网搜索(Google/Bing) npx @modelcontextprotocol/server-brave-search
Web Fetch 网页内容抓取、HTML解析 npx @modelcontextprotocol/server-fetch
Pinecone 向量数据库、语义搜索 npx @modelcontextprotocol/server-pinecone
Notion Notion文档读写、知识库管理 npx @modelcontextprotocol/server-notion
Slack Slack消息发送、频道管理 npx @modelcontextprotocol/server-slack
Jira Jira工单管理、看板查看 npx @modelcontextprotocol/server-jira

1.6 Java生态专属MCP

MCP服务器 用途 说明
Spring Tools MCP Spring Boot应用开发辅助 提供Spring生态专属上下文、Bean分析、端点映射
Maven/Gradle 构建工具集成 依赖查询、版本管理、构建执行
Java LSP Java语言服务 代码跳转、类型检查、重构支持

Spring Tools MCP配置(Eclipse/VS Code)

json 复制代码
{
  "mcpServers": {
    "spring-tools": {
      "command": "java",
      "args": ["-jar", "spring-tools-mcp-server.jar"]
    }
  }
}

注:

博客:

https://blog.csdn.net/badao_liumang_qizhi

二、Claude Code Skills清单(按类别分类)

2.1 代码审查类Skills

Skill名称 功能描述 安装命令
Code Review Pro 自动分析PR,从安全性、性能、可维护性、规范性四维度给出结构化反馈 npx skills add vercel-labs/skills --skill code-review-pro
Code Review 官方代码审查Skill,支持PR Review和提交前审查 内置 /code-review
requesting-code-review 请求代码审查的标准化流程 内置
receiving-code-review 接收并处理审查意见的Skill 内置
Java Code Review Java专属代码审查,遵循阿里规范,检查线程安全、SQL注入、资源泄漏等 自定义Skill
Security Guardian 安全审计Skill,检测OWASP Top 10漏洞、敏感信息泄露 社区Skills

2.2 测试类Skills

Skill名称 功能描述 安装命令
Test Master 自动生成单元测试、集成测试,支持JUnit 5、Mockito、Testcontainers npx skills add vercel-labs/skills --skill test-master
Playwright 端到端测试Skill,生成稳定可运行的测试脚本 npx skills add vercel-labs/skills --skill playwright
Java Test Gen Java专属测试生成,覆盖边界值、异常场景、并发测试 自定义

2.3 架构与设计类Skills

Skill名称 功能描述 安装命令
Architecture Designer 系统架构设计、技术选型、模块划分 npx skills add vercel-labs/skills --skill architecture-designer
Database Schema Designer 数据库建模、表结构设计、索引优化 npx skills add vercel-labs/skills --skill database-schema-designer
API Client Generator 根据OpenAPI/Swagger文档生成客户端代码 npx skills add vercel-labs/skills --skill api-client-generator
Refactor Assistant 代码重构助手,识别代码坏味道,给出重构方案 npx skills add vercel-labs/skills --skill refactor-assistant

2.4 文档与迁移类Skills

Skill名称 功能描述 安装命令
Documentation Writer 自动生成技术文档、API文档、README npx skills add vercel-labs/skills --skill documentation-writer
Migration Assistant 代码迁移助手,支持框架升级、语言迁移 npx skills add vercel-labs/skills --skill migration-assistant
Performance Optimizer 性能优化Skill,识别瓶颈、给出优化方案 npx skills add vercel-labs/skills --skill performance-optimizer

2.5 Java开发专属Skills

Skill名称 功能描述 触发场景
java-code-review Java代码审查,检查命名规范、异常处理、线程安全、SQL注入 "审查这段Java代码"
spring-boot-scaffold Spring Boot项目脚手架生成 "创建标准Spring Boot项目"
mybatis-generator 根据数据库表生成Entity、Mapper、Service "根据t_user表生成CRUD代码"
junit-test-gen JUnit 5测试用例生成 "为UserService生成测试"
performance-optimize Java性能优化,JVM调优、SQL优化、并发优化 "分析这个接口的性能瓶颈"
sql-optimize SQL慢查询优化 "优化这条SQL"
api-doc-gen Swagger/Knife4j接口文档生成 "生成接口文档"
docker-deploy Dockerfile和K8s配置生成 "编写Dockerfile"

2.6 通用必备Skills(安装量Top 10)

排名 Skill名称 安装量 用途
1 find-skills 579K+ Skills市场搜索器,推荐最佳Skill
2 skill-creator 37.4K+ 创建自定义Skill
3 everything-claude-code - Claude Code最佳实践合集
4 cc-switch - 多模型快速切换
5 claude-code-best-practice - 官方最佳实践
6 code-review(官方) - 官方代码审查
7 feature-dev(官方) - 功能开发全流程
8 commit-commands(官方) - Git提交规范
9 Repomix - 项目代码压缩上下文注入
10 Frontend Design - 前端UI设计规范

安装命令汇总

bash 复制代码
# find-skills(推荐首个安装)
npx skills add vercel-labs/skills --skill find-skills

# skill-creator
npx skills add vercel-labs/skills --skill skill-creator

# code-review
npx skills add vercel-labs/skills --skill code-review

# test-master
npx skills add vercel-labs/skills --skill test-master

# architecture-designer
npx skills add vercel-labs/skills --skill architecture-designer

三、Rules规则文件模板

3.1 规则文件类型对比

文件 适用工具 位置 特点
AGENTS.md 全工具通用 项目根目录、子目录 开放标准(Linux基金会AAIF托管),可跨工具移植
CLAUDE.md Claude Code 项目根目录 支持@path引用子文件,可附加项目记忆
.cursor/rules/*.mdc Cursor专属 .cursor/rules/目录 支持4种激活类型(Always/Auto Attached/Agent Requested/Manual)
.cursorrules Cursor(旧) 项目根目录 单文件,将被.mdc替代

3.2 Cursor Rules四种激活类型

类型 说明 配置示例 适用场景
Always 全局生效,每次对话都加载 基础规范、命名约定 项目核心规范(不超过50行)
Auto Attached 根据文件路径自动触发 globs: **/*.java 按技术栈区分的规范
Agent Requested AI根据上下文自主决定 AI判断是否需要加载 特定场景规范
Manual 手动触发 用户显式调用 可选规范、参考文档

3.3 Java Spring Boot项目Rules模板

文件1:.cursor/rules/core.mdc(Always类型)
markdown 复制代码
---
ruleType: Always
description: 项目核心规范
---

# 项目核心规范

## 技术栈
- Java 21 + Spring Boot 3.5 + Maven/Gradle
- MySQL 8.0 + Redis 7 + Elasticsearch 8.x
- 构建工具:Maven Wrapper(mvnw)

## 代码规范
- 严格遵循《阿里巴巴Java开发手册》
- 类名大驼峰(UserController)、方法/变量小驼峰(getUserById)
- 常量全大写下划线(MAX_RETRY_COUNT)
- 方法行数不超过80行,圈复杂度不超过10
- 禁止使用System.out.println,统一使用Slf4j

## 异常处理
- 禁止空catch块,异常必须打印堆栈
- 自定义业务异常:BusinessException
- 全局异常处理器:GlobalExceptionHandler
- 错误码定义:ErrorCode枚举

## 日志规范
- 入口/出口打印info级别(含入参、耗时、结果)
- 异常日志打印error级别(含完整堆栈、traceId)
- 使用Slf4j + Logback,禁止使用System.out

## Git规范
- 分支命名:feat/xxx、fix/xxx、refactor/xxx
- 提交信息:type(scope): description(如feat(order): 新增订单创建接口)
- 合并前必须Code Review
文件2:.cursor/rules/java-conventions.mdc(Auto Attached - *.java)
markdown 复制代码
---
ruleType: Auto Attached
globs: **/*.java
description: Java代码规范
---

# Java代码规范

## 命名规范
- Controller类:XxxController
- Service接口:XxxService,实现类:XxxServiceImpl
- Mapper接口:XxxMapper
- 实体类:XxxDO(数据库表对应)、XxxDTO(数据传输)、XxxVO(视图展示)
- 请求/响应对象:XxxRequest、XxxResponse

## 接口规范
- 所有接口返回统一结构:`Result<T>`
- Controller方法必须添加`@Operation(summary="")`
- 参数必须使用`@Valid` + `@RequestBody`
- 分页参数使用`PageQuery`,返回`PageResult<T>`

## 注释规范
- 类和公共方法必须有Javadoc
- @param、@return、@throws不能省略
- 复杂逻辑添加行内注释

## 线程安全
- SimpleDateFormat使用DateTimeFormatter替代
- 集合操作使用ConcurrentHashMap、CopyOnWriteArrayList
- 避免在同步块中调用外部服务

## 资源管理
- Stream、Connection必须try-with-resources
- @Transactional注解明确rollbackFor = Exception.class
文件3:.cursor/rules/database.mdc(Auto Attached - 数据库相关)
markdown 复制代码
---
ruleType: Auto Attached
globs: **/*Mapper.java,**/*Repository.java,**/sql/**,**/*.sql
description: 数据库规范
---

# 数据库规范

## 表设计
- 表名:t_前缀 + 下划线命名(如t_user_info、t_order_item)
- 主键:bigint自增,命名为id
- 必须包含字段:create_time、update_time、deleted(逻辑删除,tinyint默认0)
- 索引命名:idx_字段名(普通索引)、uniq_字段名(唯一索引)

## SQL规范
- 禁止SELECT *,必须明确列出字段
- 禁止${}拼接参数,统一使用#{}防注入
- WHERE条件必须带索引
- 大数据量查询必须分页(LIMIT)
- 避免在循环中查询数据库

## MyBatis规范
- 简单查询使用注解,复杂SQL写在XML
- 动态SQL使用<if>、<choose>、<foreach>
- 批量操作使用batch模式,禁止foreach拼接SQL
- ResultMap字段与属性映射明确
文件4:.cursor/rules/testing.mdc(测试相关)
markdown 复制代码
---
ruleType: Auto Attached
globs: **/test/**/*.java,**/*Test.java,*Tests.java
description: 测试规范
---

# 测试规范

## 单元测试
- 框架:JUnit 5 + Mockito
- 类命名:XxxTest
- 方法命名:test_方法名_场景(如test_createUser_phoneExist_throwException)
- 覆盖率要求:>=80%

## 测试结构(Given-When-Then)
```java
@Test
@DisplayName("创建用户-手机号已存在-抛出异常")
void createUser_phoneExists_throwException() {
    // Given
    when(userMapper.existsByPhone(anyString())).thenReturn(true);
    
    // When & Then
    assertThrows(BusinessException.class, () -> userService.createUser(request));
    verify(userMapper, never()).insert(any());
}

集成测试

  • 使用@SpringBootTest + Testcontainers
  • 数据库使用H2或Testcontainers MySQL
  • Redis使用嵌入式Redis或Testcontainers

测试数据

  • 使用@DataJpaTest测试Repository层

  • 使用@MockBean模拟外部依赖

    文件5:.cursor/rules/security.mdc(安全规范,Agent Requested)

    markdown 复制代码
    ---
    ruleType: Agent Requested
    description: 安全检查规则 - AI自主决定是否需要加载
    ---
    
    # 安全检查规则
    
    ## SQL注入
    - 检查所有SQL拼接点
    - 确认使用#{}而非${}
    - 检查MyBatis XML中的动态SQL
    
    ## XSS防护
    - 检查用户输入是否进行HTML转义
    - 富文本内容使用白名单过滤
    
    ## 权限校验
    - 检查接口是否添加@PreAuthorize
    - 确认敏感操作有权限控制
    
    ## 敏感信息
    - 日志中禁止打印密码、Token、身份证号
    - 接口返回脱敏(手机号:138****1234)
    
    ## 并发安全
    - 检查共享变量是否有线程安全问题
    - 确认锁粒度是否合理

3.4 AGENTS.md模板(通用标准)

markdown 复制代码
# 项目规约

## 技术栈
- Java 21 + Spring Boot 3.5 + Maven
- MySQL + Redis + Elasticsearch

## 代码规范
- 遵循阿里Java开发手册
- Controller/Service/Mapper分层清晰
- 统一返回Result<T>,统一异常处理

## 禁止事项
- 禁止System.out.println
- 禁止空catch块
- 禁止SELECT * 
- 禁止循环内调用数据库

## 必须操作
- 新增接口必须添加Swagger注解
- 修改代码必须先拉最新代码
- 提交前必须跑单元测试(mvn test)

## 目录说明
- src/main/java/com/example/模块名
- src/test/java/对应测试目录
- src/main/resources/mapper/MyBatis XML

3.5 CLAUDE.md模板(Claude Code专属)

markdown 复制代码
# 项目记忆

## 技术栈
@file:.claude/rules/tech-stack.md

## 代码规范  
@file:.claude/rules/code-conventions.md

## 数据库规范
@file:.claude/rules/database.md

## 测试规范
@file:.claude/rules/testing.md

## 常用命令
- 构建:`mvn clean package -DskipTests`
- 单测:`mvn test -Dtest=ClassName#methodName`
- 启动:`mvn spring-boot:run`
- 代码检查:`mvn spotbugs:check pmd:check`

## 架构约定
- 领域驱动设计(DDD)分层:interfaces → application → domain → infrastructure
- 依赖方向:上层依赖下层,禁止反向依赖
- 防腐层:领域层不直接依赖基础设施层

## 业务领域
- 核心域:订单、支付、商品
- 支撑域:用户、权限、通知
- 通用域:日志、配置、文件存储

四、MCP与Skills配置实操

4.1 Claude Code配置MCP

bash 复制代码
# 命令行添加MCP(推荐)
claude mcp add postgres -- npx @modelcontextprotocol/server-postgres postgresql://localhost/mydb

claude mcp add github -- npx @modelcontextprotocol/server-github

claude mcp add context7 -- npx @upstash/context7-mcp

claude mcp add docker -- npx @modelcontextprotocol/server-docker

# 查看已配置的MCP
claude mcp list

或手动配置 .claude/mcp.json

json 复制代码
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx" }
    },
    "docker": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/docker"]
    }
  }
}

4.2 Cursor配置MCP

json 复制代码
// .vscode/mcp.json(项目级)
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

4.3 Skills安装与使用

bash 复制代码
# 安装Skills
npx skills add vercel-labs/skills --skill find-skills
npx skills add vercel-labs/skills --skill code-review-pro
npx skills add vercel-labs/skills --skill test-master

# Claude Code中使用
# 输入 /code-review → 自动触发代码审查Skill
# 输入 /test-master → 自动生成测试用例

4.4 自定义Skills创建

bash 复制代码
# 创建Skill(交互式向导)
npx skills create

# 手动创建
mkdir -p .claude/skills/java-code-review
# 创建SKILL.md文件

SKILL.md模板示例

markdown 复制代码
---
name: java-code-review
description: Java代码审查,严格遵循阿里规范,检查异常处理、线程安全、SQL注入、性能问题
---

# Java代码审查Skill

## 触发条件用户说"审查代码"、"Code Review"、"检查一下这段代码"时触发

## 审查步骤
1. 检查命名规范(类名大驼峰、方法小驼峰)
2. 检查异常处理(禁止空catch、必须打印堆栈)
3. 检查资源管理(Stream/Connection必须try-with-resources)
4. 检查线程安全(SimpleDateFormat、HashMap并发)
5. 检查SQL注入(${}拼接、未校验参数)
6. 检查性能问题(N+1查询、大数据量未分页、循环内查DB)
7. 检查日志规范(Slf4j、关键入口打印、error级打印异常)

## 输出格式按严重等级输出:🔴 严重 / 🟡 警告 / 🟢 建议每个问题包含:- 问题描述
- 风险等级
- 代码位置
- 修复方案和代码示例

五、最佳实践与使用建议

5.1 MCP使用建议

阶段 推荐MCP 原因
入门期 Context7 + GitHub 查阅文档、管理代码,学习成本低
成长期 PostgreSQL + Docker + Redis 数据库操作、容器管理,开发刚需
进阶期 Kubernetes + Prometheus + Grafana 生产运维、监控告警
专家期 自定义业务MCP Server 将企业能力封装为Tool,AI调用

5.2 Skills使用建议

使用频率 推荐Skills 说明
每日必用 find-skills、code-review、test-master 找工具、审查、测试
项目重构 refactor-assistant、architecture-designer 重构和架构
文档编写 documentation-writer、api-doc-gen 自动生成文档
性能调优 performance-optimize、sql-optimize 定位瓶颈

5.3 Rules设计原则

  1. 渐进式加载:核心规范放Always(<50行),技术栈规范放Auto Attached,可选规范放Agent Requested
  2. 避免重复:不同Rules之间不要重复定义同一规则
  3. 定期迭代:根据AI犯错情况定期更新Rules
  4. 分层管理 :按core → language → framework → security → testing分层

5.4 避坑指南

常见问题 解决方案
MCP连接失败 检查Docker/Node.js版本,确认网络连通性
Skills不触发 检查SKILL.md格式,确认description是否清晰
Rules不生效 检查激活类型配置,确认globs路径匹配
AI生成代码不符合规范 在Rules中增加反例,使用"禁止/必须"等强约束词
上下文超限 Always类Rules控制在50行以内,Auto Attached按需加载

六、快速上手清单

第一周(入门)

第二周(进阶)

  • 配置Docker、Redis、Elasticsearch MCP
  • 安装test-master、refactor-assistant Skills
  • 创建.cursor/rules/目录结构,按模块编写Rules
  • 尝试自定义一个Skill

第三周(实战)

  • 将MCP和Skills集成到日常开发流程
  • 使用MCP查询数据库、分析日志
  • 使用Skills生成测试用例和文档
  • 根据AI使用情况迭代Rules

第四周(优化)

  • 封装业务MCP Server
  • 建立团队级Rules和Skills库
  • 形成固定的AI辅助开发工作流
  • 量化效率提升(代码产出、Bug率、文档覆盖率)

以上汇总涵盖了Java开发者在AI编程时代可能用到的核心MCP、Skills和Rules资源。建议根据项目阶段和个人需求选择性配置,避免一次性配置过多导致维护成本上升。

相关推荐
JavaDog程序狗1 小时前
【教程】WorkBuddy+Obsidian打造自动运转的个人知识库
ai编程
天涯醉青楼1 小时前
Spring Boot 接口返回 Bean 时字段名“变形”的深度剖析与解决方案
java
全栈弄潮儿1 小时前
代码报错怎么办?正确使用 AI 排查错误
aigc·openai·ai编程
zoujiahui_20182 小时前
Python 包与环境管理工具 uv
开发语言·python·uv
步行cgn2 小时前
MyBatis 高级映射与延迟加载完全指南
java·tomcat·mybatis
thefool1122662 小时前
从中序与后序遍历序列构造二叉树
java
吴声子夜歌2 小时前
Java面试题——JVM(二)
java·开发语言·jvm
CRMEB2 小时前
商城大促活动策划全流程:从定目标到复盘四阶段
java·开发语言·人工智能·ai·开源·php
denglinqings2 小时前
Java开发从入门到精通所有课程
java·开发语言