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数据库操作
RedisRedis缓存操作docker run mcp/redis缓存查看、性能调优
ElasticsearchES搜索和数据分析docker run -e ES_URL -e ES_API_KEY docker.elastic.co/mcp/elasticsearch stdio日志分析、全文搜索
MongoDBMongoDB文档数据库操作npx @modelcontextprotocol/server-mongodb文档查询、聚合管道
SQL Server微软SQL Server连接npx @modelcontextprotocol/server-mssql.NET生态Java项目

PostgreSQL MCP配置示例

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

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

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

GitHub MCP配置

{
  "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
KubernetesK8s集群管理、Pod/Deployment操作npx @modelcontextprotocol/server-kubernetes
Terraform基础设施即代码管理自定义MCP或社区实现
Prometheus监控数据查询、告警查看docker run mcp/prometheus
Grafana仪表板查看、数据源管理npx @modelcontextprotocol/server-grafana
JenkinsCI/CD流水线管理自定义MCP实现

1.4 开发工具类MCP

MCP服务器用途安装方式
Context7实时获取第三方库文档(React、Next.js、Prisma等10000+库)npx @upstash/context7-mcp
Swagger/OpenAPIAPI文档解析、接口定义导入npx @modelcontextprotocol/server-openapi
JSON SchemaJSON数据验证、Schema生成社区实现
PlantUMLUML图生成、架构图绘制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
NotionNotion文档读写、知识库管理npx @modelcontextprotocol/server-notion
SlackSlack消息发送、频道管理npx @modelcontextprotocol/server-slack
JiraJira工单管理、看板查看npx @modelcontextprotocol/server-jira

1.6 Java生态专属MCP

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

Spring Tools MCP配置(Eclipse/VS Code)

{
  "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 ReviewJava专属代码审查,遵循阿里规范,检查线程安全、SQL注入、资源泄漏等自定义Skill
Security Guardian安全审计Skill,检测OWASP Top 10漏洞、敏感信息泄露社区Skills

2.2 测试类Skills

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

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文档、READMEnpx 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-reviewJava代码审查,检查命名规范、异常处理、线程安全、SQL注入“审查这段Java代码”
spring-boot-scaffoldSpring Boot项目脚手架生成“创建标准Spring Boot项目”
mybatis-generator根据数据库表生成Entity、Mapper、Service“根据t_user表生成CRUD代码”
junit-test-genJUnit 5测试用例生成“为UserService生成测试”
performance-optimizeJava性能优化,JVM调优、SQL优化、并发优化“分析这个接口的性能瓶颈”
sql-optimizeSQL慢查询优化“优化这条SQL”
api-doc-genSwagger/Knife4j接口文档生成“生成接口文档”
docker-deployDockerfile和K8s配置生成“编写Dockerfile”

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

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

安装命令汇总

# 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.mdClaude Code项目根目录支持@path引用子文件,可附加项目记忆
.cursor/rules/*.mdcCursor专属.cursor/rules/目录支持4种激活类型(Always/Auto Attached/Agent Requested/Manual)
.cursorrulesCursor(旧)项目根目录单文件,将被.mdc替代

3.2 Cursor Rules四种激活类型

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

3.3 Java Spring Boot项目Rules模板

文件1:.cursor/rules/core.mdc(Always类型)
---
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)
---
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 - 数据库相关)
---
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(测试相关)
---
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模板(通用标准)

# 项目规约

## 技术栈
- 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专属)

# 项目记忆

## 技术栈
@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

# 命令行添加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

{
  "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

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

4.3 Skills安装与使用

# 安装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创建

# 创建Skill(交互式向导)
npx skills create

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

SKILL.md模板示例

---
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按需加载

六、快速上手清单

第一周(入门)

  • 安装Cursor或Claude Code
  • 配置3个基础MCP(GitHub、Context7、PostgreSQL)
  • 安装find-skills和code-review Skills
  • 编写项目AGENTS.md和CLAUDE.md

第二周(进阶)

  • 配置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资源。建议根据项目阶段和个人需求选择性配置,避免一次性配置过多导致维护成本上升。

Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐