ripple-impact-mcp

<div align="center"> # Ripple-MCP **字段级语义变更影响分析 · Field-Level Semantic Change Impact Analysis** [中文](#-中文) · [English](#-english) </div> --- ## 🇨🇳 中文 ### 为什么需要 Ripple-MCP？ 当你想分析「修改 `machine.x/y` 语义」或「把某字段类型从 `INT` 改为 `VARCHAR`」会影响哪些代码时，传统工具无法回答： | 问题 | 示例 | |------|------| | 哪些地方直接读取了这个字段？ | `obj.x` / `obj['x']` / `obj.get('x')` | | 哪些地方用了这个字符串值？ | `"success"` / `"failed"` | | 哪些地方调用了这个函数？ | `get_eq_partition()` | | 哪些文件导入了这个模块？ | `from plogen_tools import ...` | | TypeScript / JavaScript 里哪些地方用了这个变量？ | — | | 改了函数 X，哪些函数直接调用了它？ | — | **Ripple-MCP 把 Claude Code 的语义理解与 ripgrep / Python AST 的机械精确性结合，覆盖 codegraph 的所有盲区。** --- ### 核心工具 | 工具 | 说明 | |------|------| | `scan_patterns` | 通用正则扫描，支持任意语言 | | `analyze_python_ast` | 精准 Python AST 分析，区分属性访问 / 下标 / `.get()` | | `trace_callers` | 多层调用链追踪（BFS 上溯「调用者的调用者」，最多 5 层） | | `find_definition` | 符号定义查找（函数 / 类 / 常量，含签名与所在类） | | `generate_impact_report` | 语义变更影响的结构化 Markdown 报告 | | `get_code_context` | 带上下文的代码片段提取 | --- ### 安装 **环境要求：** Python 3.10+ ```bash pip install ripple-impact-mcp ``` > 包名为 `ripple-impact-mcp`（PyPI 上 `ripple-mcp` 已被占用），安装后的命令行入口仍是 `ripple-mcp`。 或源码安装： ```bash git clone https://github.com/0xYubo/Ripple-Mcp.git cd Ripple-Mcp pip install -e . ``` **Claude Code 集成（MCP 配置）：** ```bash # 方式一：命令行一键添加（推荐，-s user 表示全局可用） claude mcp add ripple -s user -- ripple-mcp ``` ```json // 方式二：手动编辑 MCP 配置文件 { "mcpServers": { "ripple": { "command": "ripple-mcp" } } } ``` > `ripple-mcp` 是 `pip install -e .` 注册的命令行入口，等价于 `python -m field_impact_mcp`。 配置完成后重启 Claude Code 即可生效。 --- ### 使用方式 无需手动调用任何工具——在 Claude Code 对话中**用自然语言描述变更意图**，Claude 会自动编排下面的工具完成分析。 **字段类型变更** ``` 分析「把 all_check 表的 survey_status_today 字段从 INT 改为 VARCHAR」 对 /path/to/backend 的影响范围 ``` **坐标语义变更** ``` 如果把机台坐标 x/y 从左上角改为中心点， /path/to/project 里哪些地方需要修改？ ``` **函数重命名** ``` 把 get_eq_partition 重命名为 get_machine_partition， /path/to/backend 里有多少个调用点？ ``` **API 路径变更** ``` /api/external/apiKey/refresh 改为 /api/external/ap…