Git 文件取证 MCP
用于深度 git 文件级取证的 MCP 工具,有助于深入了解文件历史、更改和模式,专注于单个文件分析而不是存储库范围的操作。
安装
- 克隆并构建服务器:
git clone [repository-url]
cd git-file-forensics
npm install
npm run build
- 添加到您的 MCP 设置(
~/Library/Application Support/Code/User/globalStorage/david-dafu-dev.dafu/settings/cline_mcp_settings.json
):
{
"mcpServers": {
"git-file-forensics": {
"command": "/opt/homebrew/bin/node",
"args": ["/path/to/git-file-forensics/build/index.js"],
"alwaysAllow": []
}
}
}
可用工具
1. track_file_versions
跟踪特定文件的完整版本历史记录,包括重命名和移动。
{
"method": "tools/call",
"params": {
"name": "track_file_versions",
"arguments": {
"repoPath": "/path/to/repo",
"file": "path/to/file",
"outputPath": "output.json"
}
}
}
2. 分析文件差异
分析文件任意两个版本之间的具体变化。
{
"method": "tools/call",
"params": {
"name": "analyze_file_diff",
"arguments": {
"repoPath": "/path/to/repo",
"file": "path/to/file",
"versions": {
"from": "commit-hash-1",
"to": "commit-hash-2"
},
"outputPath": "output.json"
}
}
}
3. 分析文件上下文
分析特定提交中文件更改的更广泛的背景。
{
"method": "tools/call",
"params": {
"name": "analyze_file_context",
"arguments": {
"repoPath": "/path/to/repo",
"file": "path/to/file",
"commit": "commit-hash",
"outputPath": "output.json"
}
}
}
4. 分析文件语义
分析文件历史中的语义变化和模式。
{
"method": "tools/call",
"params": {
"name": "analyze_file_semantics",
"arguments": {
"repoPath": "/path/to/repo",
"file": "path/to/file",
"outputPath": "output.json"
}
}
}
输出格式
所有工具输出的 JSON 文件均包含以下内容:
- 详细分析结果
- 汇总统计数据
- 改变模式和关系
- 风险评估(如适用)
要求
- Node.js
- Git(必须安装并可访问)
- MCP SDK
执照
该项目根据 Apache 许可证 2.0 版获得许可 - 有关详细信息,请参阅LICENSE.txt文件。
版权所有 davidorex.ai。本项目遵循 Apache 许可证 2.0 版;除非遵守该许可证,否则您不得使用本项目。您可以访问http://www.apache.org/licenses/LICENSE-2.0获取许可证副本。