Skip to content
Back to search

JavaSinkTracer_MCP

基于函数级污点分析的 Java 源代码漏洞审计工具JavaSinkTracer,通过 Model Context Protocol (MCP) 为 AI 助手提供安全分析能力。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zacarx--javasinktracer-mcp/badge.svg)](/listings/zacarx--javasinktracer-mcp)

HTML

<a href="/listings/zacarx--javasinktracer-mcp"><img src="/api/listings/zacarx--javasinktracer-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 240 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # JavaSinkTracer_MCP
  2. 基于函数级污点分析的 Java 源代码漏洞审计工具JavaSinkTracer,通过 Model Context Protocol (MCP) 为 AI 助手提供安全分析能力。
  3. ## 快速开始
  4. ### 1. 安装依赖
  5. ```bash
  6. pip install -r requirements.txt
  7. ```
  8. ### 2. 配置 Claude Desktop
  9. 编辑配置文件并添加 MCP 服务器配置:
  10. **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  11. **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
  12. ```json
  13. {
  14. "mcpServers": {
  15. "javasinktracer": {
  16. "command": "python",
  17. "args": [
  18. "/path/to/JavaSinkTracer/mcp_server.py"
  19. ],
  20. "description": "Java源代码漏洞审计工具 - 基于函数级污点分析"
  21. }
  22. }
  23. }
  24. ```
  25. **注意**:将 `/path/to/JavaSinkTracer` 替换为实际的项目路径。
  26. ### 3. 重启 Claude Desktop
  27. 配置完成后重启 Claude Desktop,MCP 工具将自动加载。
  28. ## 视频演示
  29. https://www.bilibili.com/video/BV1XrxDz1EvF
  30. ## 核心功能
  31. ### 漏洞扫描
  32. 从危险函数(Sink)反向追踪到外部入口(Source),自动发现潜在的安全漏洞链路。
  33. ### 调用图分析
  34. 构建完整的 Java 项目函数调用关系图,支持跨文件、跨类的调用追踪。
  35. ### 智能分析
  36. 基于函数级污点分析,有效规避变量级追踪在复杂场景(线程、反射、回调)下的断链问题。
  37. ### 代码提取
  38. 自动提取漏洞链路上每个函数的完整源代码,便于人工或 AI 深入分析。
  39. ## 可用工具
  40. | 工具名称 | 功能说明 |
  41. |---------|---------|
  42. | `build_callgraph` | 构建项目调用关系图 |
  43. | `find_vulnerabilities` | 扫描安全漏洞 |
  44. | `analyze_vulnerability_chain` | 分析漏洞调用链源代码 |
  45. | `extract_method_code` | 提取指定方法源代码 |
  46. | `list_sink_rules` | 查看漏洞规则配置 |
  47. | `get_project_statistics` | 获取项目统计信息 |
  48. ## 使用示例
  49. ### 示例 1:全面漏洞扫描
  50. ```
  51. 请帮我扫描 /path/to/java-project 项目的安全漏洞
  52. ```
  53. AI 会自动:
  54. 1. 构建调用关系图
  55. 2. 扫描所有类型的漏洞
  56. 3. 分析并报告发现的问题
  57. ### 示例 2:针对性检测
  58. ```
  59. 检查项目中是否存在 SQL 注入和命令执行漏洞
  60. ```
  61. AI 会扫描特定类型的漏洞(SQLI、RCE)。
  62. ### 示例 3:深入分析
  63. ```
  64. 这个漏洞链路是真实漏洞吗?请分析调用链的源代码
  65. ```
  66. AI 会提取完整的调用链代码并进行分析。
  67. ## 支持的漏洞类型
  68. - **RCE** - 远程代码执行 (CWE-78)
  69. - **SQLI** - SQL 注入 (CWE-89)
  70. - **XXE** - XML 外部实体注入 (CWE-611)
  71. - **SSRF** - 服务端请求伪造 (CWE-918)
  72. - **PATH_TRAVERSAL** - 路径穿越 (CWE-22)
  73. - **DESERIALIZE** - 反序列化漏洞 (CWE-502)
  74. - **XPATH_INJECTION** - XPath 注入 (CWE-643)
  75. - **TEMPLATE_INJECTION** - 模板注入 (CWE-94)
  76. - **JNDI_INJECTION** - JNDI 注入 (CWE-74)
  77. - **REFLECTION_INJECTION** - 反射注入 (CWE-470)
  78. - **LOG_INJECTION** - 日志注入 (CWE-117)
  79. - **CRYPTO_WEAKNESS** - 加密算法弱点 (CWE-327)
  80. ## 支持的框架
  81. - Spring Boot / Spring MVC
  82. - MyBatis / Hibernate / JPA
  83. - Fastjson / Jackson / Gson
  84. - OkHttp / Apache HttpClient
  85. - Freemarker / Velocity / Thymeleaf
  86. - Log4j / SLF4J
  87. ## 工作原理
  88. ### 函数级污点分析
  89. 不同于传统 SAST 工具的"变量级"污点分析,本工具采用"函数级"污点分析:
  90. - **优势**:有效规避线程调用、监听回调、反射调用等场景的断链问题
  91. - **权衡**:可能产生误报,需要结合 AI 或人工进一步分析确认
  92. ### 分析流程
  93. 1. 解析 Java 源代码,构建 AST
  94. 2. 提取所有类和方法信息
  95. 3. 构建函数调用关系图
  96. 4. 从 Sink 点(危险函数)反向追踪
  97. 5. 识别到达 Source 点(外部入口)的调用链
  98. 6. 过滤无参数的函数(排除不可控变量)
  99. 7. 提取调用链上所有函数的源代码
  100. ## 配置说明
  101. ### 规则文件
  102. 规则配置文件位于 `Rules/rules.json`,包含:
  103. - **sink_rules**: 危险函数规则(如 `Runtime.exec`)
  104. - **source_rules**: 外部输入源(如 `HttpServletRequest.getParameter`)
  105. - **sanitizer_rules**: 净化函数(如 `StringEscapeUtils.escapeHtml`)
  106. ### 自定义规则
  107. 可以根据实际需求编辑 `rules.json` 添加新的 Sink、Source 或 Sanitizer 规则:
  108. ```json
  109. {
  110. "sink_rules": [
  111. {
  112. "sink_name": "CUSTOM_VULN",
  113. "sink_desc": "自定义漏洞类型",
  114. "severity_level": "High",
  115. "cwe": "CWE-XXX",
  116. "sinks": [
  117. "com.example.DangerousClass:dangerousMethod"
  118. ]
  119. }
  120. ]
  121. }
  122. ```
  123. ## 性能优化
  124. ### 缓存机制
  125. - 首次分析项目时构建 AST 和调用图
  126. - 后续调用自动复用缓存,大幅提升速度
  127. - 缓存 key:`project_path:rules_path`
  128. ### 轻量级模式
  129. `find_vulnerabilities` 工具默认使用轻量级模式:
  130. - 仅返回漏洞链路信息
  131. - 不立即提取源代码
  132. - 需要时使用 `analyze_vulnerability_chain` 获取详细代码
  133. ## 常见问题
  134. ### 工具未加载?
  135. 1. 检查配置文件中的路径是否正确
  136. 2. 确认已安装所有 Python 依赖
  137. 3. 查看 Claude Desktop 的开发者工具日志
  138. ### 分析速度慢?
  139. - 大型项目首次分析需要时间构建 AST
  140. - 使用缓存后速度会显著提升
  141. - 可先调用 `build_callgraph` 预热缓存
  142. ### 结果有误报?
  143. - 函数级污点分析会产生一定误报
  144. - 使用 `analyze_vulnerability_chain` 查看源代码
  145. - 结合 AI 分析或人工确认漏洞真实性
  146. ## 扩展开发
  147. ### 添加新的 MCP 工具
  148. 编辑 `mcp_server.py`:
  149. ```python
  150. @app.list_tools()
  151. async def list_tools() -> list[Tool]:
  152. return [
  153. Tool(
  154. name="your_tool",
  155. description="工具描述",
  156. inputSchema={...}
  157. )
  158. ]
  159. @app.call_tool()
  160. async def call_tool(name: str, arguments: Any):
  161. if name == "your_tool":
  162. # 实现你的工具逻辑
  163. pass
  164. ```
  165. ## 相关资源
  166. - **详细使用指南**: 查看 `MCP_GUIDE.md`
  167. - **原理说明**: 查看 `README.md`
  168. - **优化日志**: 查看 `UPGRADE_SUMMARY.md`
  169. ## 致谢
  170. JavaSinkTracer开发者 [Tr0e](https://github.com/Tr0e)
  171. ## 声明
  172. 本项目仅供学习与研究使用,请勿用于商业或非法用途。因使用本项目产生的任何后果由使用者自行承担。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.