YanceLint MCP Server

让 AI（Claude Code）实时感知代码规约违规。

简介

YanceLint MCP Server 是 YanceLint 的 Model Context Protocol (MCP) 接口，让支持 MCP 的 AI 工具（如 Claude Code）能够实时获取代码规约检查结果。

安装

无需手动安装，Claude Code 通过 npx 自动拉取最新版本。只需在项目中配置 MCP Server 即可（见下方「注册到 Claude Code」）。

如需手动运行：

npx @xihe-lab/yance-mcp-server

注册到 Claude Code

方式一：项目级配置（推荐）

在项目根目录创建 .mcp.json，团队成员共享：

{
  "mcpServers": {
    "yancelint": {
      "command": "npx",
      "args": ["-y", "@xihe-lab/yance-mcp-server"]
    }
  }
}

方式二：全局配置

在 ~/.claude/settings.json 中添加，所有项目生效：

{
  "mcpServers": {
    "yancelint": {
      "command": "npx",
      "args": ["-y", "@xihe-lab/yance-mcp-server"]
    }
  }
}

方式三：全局安装后使用

npm install -g @xihe-lab/yance-mcp-server

配置中直接使用命令名：

{
  "mcpServers": {
    "yancelint": {
      "command": "yance-mcp-server"
    }
  }
}

npx -y 会自动从 npm 拉取最新版本运行，无需手动安装。

工具列表

工具	描述
get_file_violations	获取指定文件的规约违规列表（来自 P3C/ESLint/Stylelint/Checkstyle）
get_project_summary	获取项目级扫描摘要，包含各工具违规总数
check_health	检查 YanceLint Server 运行状态

前置条件

需要 YanceLint 插件 在 IntelliJ IDEA 中运行：

1. 安装 YanceLint 插件到 IDEA
2. 打开项目时，HTTP Server 自动在 localhost:63742 启动
3. 确保 ESLint/Stylelint/P3C/Checkstyle 相关工具已配置

使用示例

在 Claude Code 中：

> 检查 src/pages/Home.tsx 有什么规约违规

AI 会自动调用 get_file_violations 工具获取违规列表并给出修复建议。

相关项目

• yance-idea — YanceLint IntelliJ IDEA 插件
• Claude Code — Anthropic 官方 AI 编程助手

许可证

Apache License 2.0

Copyright 2025 Xihe Lab (羲和实验室)

详见 LICENSE 和 NOTICE 文件。

联系方式

• 网站：https://www.xihe-lab.com
• 问题反馈：https://github.com/xihe-lab/yance-mcp-server/issues