Vba Lint MCP

vba-lint mcp

 ](https://nodejs.org/) 

提供VBA代码检查、linting和解析树分析的MCP服务器——从Rubberduck VBA移植的65个检查。

概述

vba-lint-mcp 通过以下方式公开VBA静态分析功能 模型上下文协议，使AI助手（Claude Code等）和MCP兼容工具能够对VBA源文件执行代码质量检查。

检查逻辑源自 橡胶鸭VBA 项目——一个开源的VBIDE插件，为VBA开发人员提供代码检查、重构、导航和单元测试。该项目将Rubberduck经过验证的C#检查模式转换为TypeScript，并通过MCP访问它们。

这是给谁的？

• VBA开发人员使用Claude Code或其他MCP客户端提供代码帮助
• 需要自动代码质量检查的维护Excel/Access VBA项目的团队
• 任何构建包含VBA支持的基于MCP的开发工具链的人

快速开始

安装

git clone git@github.com:devinmlowe/vba-lint-mcp.git
cd vba-lint-mcp
npm install
npm run generate-parser   # Requires Java 17+ (JRE)
npm run build

在Claude代码中配置

添加到MCP设置(.claude/settings.json 或项目设置）：

{
  "mcpServers": {
    "vba-lint": {
      "command": "node",
      "args": ["/path/to/vba-lint-mcp/dist/server.js"],
      "env": {
        "VBA_LINT_LOG_LEVEL": "warn"
      }
    }
  }
}

第一次检查

配置后，Claude Code可以直接检查VBA代码：

> Inspect this VBA code for issues:
>
> Sub Example()
>     Dim x
>     Let y = 10
>     If True Then
>     End If
> End Sub

服务器将返回缺失的诊断信息 Option Explicit，隐式变量类型，已过时 Let 关键字和空 If 块。

工具

vba/inspect

对VBA代码字符串运行检查。

输出示例：

{
  "results": [
    {
      "inspection": "EmptyIfBlock",
      "description": "If block is empty and should either contain code or be removed.",
      "severity": "warning",
      "category": "CodeQuality",
      "tier": "A",
      "location": { "startLine": 3, "startColumn": 4, "endLine": 4, "endColumn": 10 },
      "quickFix": { "description": "Remove the empty If block" },
      "suppressed": false
    }
  ],
  "errors": [],
  "skippedInspections": [],
  "parseErrors": [],
  "engineVersion": "0.1.0"
}

vba/inspect-workspace

扫描VBA文件（.bas、.cls、.frm）的目录树，并返回聚合结果。

在摘要模式（默认）下，按文件和检查返回计数。在详细模式下，为每个发现返回完整的结果对象。

vba/list-inspections

列出所有可用的检查及其元数据。

vba/parse

解析VBA源代码并返回AST。

有助于理解代码结构。这 depth 参数限制了大型模块的序列化大小。

检验目录

在2个级别和8个类别中进行了65次检查。

A级：解析树检查（43）

这些检查直接分析ANTLR4解析树，不需要符号解析。它们在两个内联代码上运行(vba/inspect)以及工作空间扫描。

B级：符号感知检查（22）

这些检查需要符号解析（声明收集+参考解析）。它们在内联代码和工作区扫描上运行，工作区扫描提供跨模块解析。

配置

主机库

这 hostLibraries 参数控制运行哪些特定于主机的检查。默认值为 ["excel"].Excel特定检查（ImplicitActiveSheetReference等）仅在以下情况下运行 "excel" 包括在内。

.vbalintignore

对于工作区扫描，创建 .vbalintignore 使用glob模式排除文件的文件：

# Ignore generated code
generated/**
*.generated.bas

# Ignore test fixtures
test/**

计划功能

设计了以下功能，但 尚未实现:

.vbalintrc.json （计划中）

用于自定义严重性覆盖和默认主机库的项目级配置文件：

{
  "hostLibraries": ["excel"],
  "severity": {
    "EmptyIfBlock": "error",
    "StepNotSpecified": "off"
  }
}

@Ignore 注释抑制（计划中）

使用VBA注释注释内联抑制特定检查：

'@Ignore EmptyIfBlock
If condition Then
End If

'@Ignore EmptyIfBlock, ObsoleteLetStatement

码头工人

构建

docker build -t vba-lint-mcp .

使用Docker Compose运行

docker compose build
docker compose run --rm vba-lint

MCP服务器使用stdio传输（stdin/stdout JSON-RPC），因此必须以交互方式运行(docker compose run)，未分离(docker compose up).

装载VBA文件以进行工作区扫描

编辑 docker-compose.yml 要装载VBA项目目录，请执行以下操作：

services:
  vba-lint:
    build: .
    stdin_open: true
    volumes:
      - ./my-vba-project:/data:ro

然后使用 vba/inspect-workspace 工具与 path: "/data".

图像大小

运行时映像使用 node:22-alpine 非root用户。包含源文件以符合GPL-3.0标准。

发展

设置

npm install
npm run generate-parser   # Requires Java 17+
npm run build

测试

npm test                  # All tests
npm run test:watch        # Watch mode
npx vitest run 
     # Specific test

添加检查

看 贡献.md 获取添加新检查的分步指南。

项目结构

src/
  server.ts              # MCP server entry point
  inspections/
    base.ts              # Inspection contracts
    registry.ts          # Master registration
    runner.ts            # Tiered execution engine
    parse-tree/          # Tier A inspections (by category)
    declaration/         # Tier B inspections
  parser/                # ANTLR4 parser facade
  symbols/               # Symbol resolution (Tier B)
  annotations/           # @Ignore annotation parsing
grammar/
  VBALexer.g4            # ANTLR4 lexer grammar (from Rubberduck)
  VBAParser.g4           # ANTLR4 parser grammar (from Rubberduck)

已知限制

• 条件编译 (#If, #Const, #Else)未进行预处理。所有分支都被解析为活动代码，这可能会在使用条件编译的模块中产生误报。
• C级检查 （COM类型库依赖、Rubberduck注释系统、VBE运行时）超出范围。看 计划.md 查看完整列表。

归因

这个项目是 橡胶鸭VBAVBA语法和检查逻辑是从Rubberduck的C#代码库翻译而来的。

版权所有（C）Rubberduck贡献者 --根据GPL-3.0获得许可。

看 属性.md 完整的归因、衍生作品表和贡献者确认。

许可证

该项目根据 GNU通用公共许可证v3.0。参见 许可证 全文。

根据GPL-3.0：

• 所有派生检查逻辑都保留了Rubberduck VBA的属性
• 每个派生文件都包含一个每个文件的版权标头
• Docker镜像包含完整的源代码（GPL-3.0第6节）
• 本项目的消费者必须遵守GPL-3.0条款