mcp-multi-root-git/schemas/git_diff.json at main · Rethunk-AI/mcp-multi-root-git · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "@rethunk/mcp-multi-root-git: git_diff",
  "description": "Parameter schema for the 'git_diff' MCP tool.",
  "type": "object",
  "properties": {
    "workspaceRoot": {
      "description": "Highest-priority override.",
      "type": "string"
    },
    "rootIndex": {
      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    },
    "base": {
      "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Required for range diffs. If omitted and `staged: false`, shows unstaged changes.",
      "type": "string"
    },
    "head": {
      "description": "Head ref (e.g. \"feature-branch\"). If omitted, defaults to HEAD. Only used if `base` is provided.",
      "type": "string"
    },
    "path": {
      "description": "Scope diff to a single file path (e.g. \"src/main.ts\"). For multiple files, prefer `paths`. If both `path` and `paths` are given, they are unioned.",
      "type": "string"
    },
    "paths": {
      "description": "Scope diff to multiple file paths (e.g. [\"src/a.ts\", \"src/b.ts\"]). Each path is validated and must lie within the repository root. If both `path` and `paths` are given, they are unioned.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "staged": {
      "default": false,
      "description": "If true, show staged changes (git diff --staged). Ignored if `base` is provided.",
      "type": "boolean"
    },
    "unified": {
      "description": "Number of context lines to show around each change (passed as -U<n> to git diff). Defaults to git's built-in default (3). Use 0 for no context.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "format",
    "staged"
  ],
  "additionalProperties": false
}