Test Impact Analysis MCP Server（TIA）

面向软件测试人员的智能代码变更影响分析 MCP 工具集

持续监控代码仓库变更，自动拉取增量代码，集成外部静态分析引擎，
覆盖测试生命周期中的 变更感知 → 影响分析 → 用例推荐 → 风险评估 全链路。

📦 包含内容

从初始 7 个工具合并为 3 个（精简 57%），Phase 2-4 新增 2 个分析工具（5 个）。安全认证从两层（API KEY + IP）精简为一层（IP 白名单）。简单、实用、免维护。

🎯 项目定位

┌──────────────────────────────────────────────────────┐
│ Claude Code / OpenCode / Codex (Host)                │
│  ├─ CronCreate → 定时触发 repo_monitor               │
│  ├─ /repo_xxx 斜杠命令 → 快捷操控                    │
│  └─ MCP Client (stdio / http transport)               │
└─────────┬──────────────┬──────────────────────────────┘
          │ stdio (本地)  │ http (远程)
┌─────────▼────────┐ ┌──▼───────────────────────────────┐
│ 直接进程通信      │ │ Express App (port 3100)          │
│ (零配置)          │ │  └─ IP 白名单 → 通过/403         │
│ 直接执行 git clone │ └──────────────────────────────────┘
└──────────────────┘

┌──────────────────────────────────────────────────────┐
│ TIA MCP Server                                       │
│                                                      │
│  ┌─────────────────────────────────────────────┐     │
│  │ 模块 1: Git Monitor                          │     │
│  │ repo_monitor + repo_clone                   │     │
│  │ GitHub / Local / Generic 三平台适配           │     │
│  └─────────────────────────────────────────────┘     │
│  ┌─────────────────────────────────────────────┐     │
│  │ 模块 2: Impact Analysis + 引擎增强            │     │
│  │ impact_analysis + codebase-memory-mcp        │     │
│  │ BFS 调用链逆向追踪 + glob 文件级兜底          │     │
│  └─────────────────────────────────────────────┘     │
│  ┌─────────────────────────────────────────────┐     │
│  │ 模块 3: Test Recommendation                  │     │
│  │ test_recommendation                         │     │
│  │ 推荐分 = 风险权重 × 置信度                    │     │
│  └─────────────────────────────────────────────┘     │
│  ┌─────────────────────────────────────────────┐     │
│  │ 模块 4: Risk Assessment                      │     │
│  │ risk_assessment                             │     │
│  │ 文件+模块+置信度 三维评分 (0-100)             │     │
│  └─────────────────────────────────────────────┘     │
└──────────────────────────────────────────────────────┘

🚀 快速开始

1️⃣ 克隆并安装

git clone [email protected]:WayneLiu519888/Test-Impact-Analysis-MCP.git
cd Test-Impact-Analysis-MCP
npm install          # 自动安装 git hooks

2️⃣ 配置你的仓库

cp examples/monitors.conf.example.json enterprise/monitors.conf.json
vim enterprise/monitors.conf.json   # 填入你要监控的仓库

3️⃣ 配置 MCP 连接

Stdio 本地模式（零配置）：

// .claude/settings.local.json
{ "enabledMcpjsonServers": ["test-impact-analysis"] }

HTTP 远程模式（需先配置 IP 白名单）：

{
  "mcpServers": {
    "test-impact-analysis": {
      "type": "http",
      "url": "http://your-server:3100/mcp"
    }
  }
}

4️⃣ 开始使用

/repo_status                              # 查看仓库水位
/repo_check module=用户中心                # 检查新提交
/repo_clone full module=用户中心           # 克隆代码
impact_analysis(name="backend")           # 变更影响分析
test_recommendation(name="backend")       # 测试推荐
risk_assessment(name="backend")           # 风险评估

✨ 完成！ 代码变更自动感知 + 增量代码拉取 + 精准测试影响分析。

🛠️ 5 个 MCP 工具

所有 5 个工具在 stdio 和 HTTP 模式下均可用。

🔬 分析引擎集成

TIA 支持接入外部代码静态分析引擎，提供方法级精确调用链分析能力。首个支持的引擎是 codebase-memory-mcp。

codebase-memory-mcp 引擎

单一静态二进制（~36MB），基于 tree-sitter 支持 158 种编程语言，零运行时依赖。

# 安装（PowerShell，3 步）
mkdir D:\0_WayneArchiveFiles\MCP-Servers\codebase-memory-mcp
curl -o "$env:TEMP\cbm.zip" "https://github.com/DeusData/codebase-memory-mcp/releases/latest/download/codebase-memory-mcp-windows-amd64.zip"
Expand-Archive "$env:TEMP\cbm.zip" D:\0_WayneArchiveFiles\MCP-Servers\codebase-memory-mcp
.\codebase-memory-mcp.exe --version    # → codebase-memory-mcp 0.8.1

# 启用引擎
# 编辑 engines.conf.json → "enabled": true

工作流程

impact_analysis 调用
  └─ .java/.ts/.py 等 → codebase-memory-mcp CLI 子进程
      ├─ index_repository    → 索引代码到本地 SQLite
      ├─ get_architecture    → 提取方法/入口点
      ├─ query_graph         → 提取全部 CALLS 调用边
      └─ 翻译为 PanoramaIndex → BFS 调用链逆向遍历
          └─ 合并到 TIA 影响分析报告

✅ 代码分析 100% 本地 | 🔌 引擎不可用时静默降级到 glob 匹配 | 📖 完整配置指导

🌐 跨平台支持

同一套 MCP 工具，三个 AI 编程框架共享。

📥 安装方式

Claude Code (stdio)

// .claude/settings.local.json
{ "enabledMcpjsonServers": ["test-impact-analysis"] }

Claude Code (HTTP 远程)

{
  "mcpServers": {
    "test-impact-analysis": {
      "type": "http",
      "url": "http://your-server:3100/mcp"
    }
  }
}

# 服务端启动
MCP_TRANSPORT=http MCP_PORT=3100 npx tsx src/index.ts

OpenCode / Codex

详见项目内 .opencode/commands/ 和 .codex/skills/ 目录。

📂 仓库目录

Test-Impact-Analysis-MCP/
│
├── src/
│   ├── index.ts                  # MCP Server 入口 + Transport 双模
│   ├── types.ts / state.ts       # 类型定义 / 配置状态管理
│   ├── security.ts               # IP 白名单
│   ├── paths.ts                  # 路径定位 + 企业配置层
│   ├── platforms/                # Git 平台适配器（GitHub/Local/Generic）
│   ├── tools/                    # MCP 工具模块（schemas + helpers + 3 handler）
│   ├── impact-analysis/          # 影响分析 / 推荐 / 风险评估
│   ├── engines/                  # 分析引擎框架
│   │   └── adapters/             # codebase-memory-mcp 适配器
│   └── tests/                    # 65 个单元测试
│
├── examples/                     # 配置模板（.example.json）
├── docs/                         # 多语言文档
├── .claude/commands/             # Claude Code 斜杠命令
├── .opencode/commands/           # OpenCode 命令
├── .codex/skills/               # Codex 技能
│
├── enterprise/                   # 🔒 企业配置层（.gitignore 排除）
│   ├── monitors.conf.json        #   仓库监控配置
│   ├── server.conf.json          #   IP 白名单配置
│   ├── impact-rules.conf.json    #   影响分析规则
│   └── engines.conf.json         #   引擎配置
│
└── Repository/                   # 🚫 克隆的代码（.gitignore 排除）

🔒 信息安全

┌─────────────────────────────────┐
│ 开源层（提交 GitHub ✅）          │
│ src/ docs/ examples/ README     │
│ 不含企业 URL / 仓库 / 内网 IP    │
├─────────────────────────────────┤
│ 企业层（.gitignore 排除 ❌）      │
│ enterprise/ 整目录               │
│ 仓库地址 / IP 白名单 / 业务模块   │
└─────────────────────────────────┘

两层防护：.gitignore 排除 enterprise/ + Pre-commit hook 实时拦截。

HTTP 安全：IP 白名单（精确 IP + CIDR 子网），白名单内可直接连接全部 5 个工具。

❓ FAQ

npm start              # npx tsx src/index.ts
npm run dev            # tsx --watch（热重载）
npx tsc --noEmit       # 类型检查
npm test               # 65 个测试

📋 环境要求

🔧 可用命令

🗺️ 开发路线图

📄 许可证

MIT — 自由使用，按需修改，欢迎回馈。

_{设计蓝图 → ultimate-blueprint-v3.md}

_{🤖 Generated with Claude Code}