codegraph/plugin.json at main · JohnXu22786/codegraph · 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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
  "name": "codegraph",
  "displayName": "CodeGraph",
  "version": "1.0.0",
  "description": "Code knowledge graph plugin: indexes a codebase (symbols, call sites, module imports) into a local SQLite store and answers call/dependency questions for agents through a stdio tool server (MCP-style JSON-RPC).",
  "license": "MIT",
  "language": "python",
  "requires": ">=3.10",
  "entry": {
    "cli": "python -m codegraph",
    "tool_server": "python -m codegraph serve",
    "python_api": "import codegraph"
  },
  "protocols": ["mcp-stdio", "json-rpc-2.0"],
  "tools": [
    {
      "name": "callers",
      "description": "List every symbol that calls the given symbol directly. Use impact for the transitive caller set.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "symbol": {"type": "string", "description": "qualified symbol name, e.g. pkg.cart.Cart.add"},
          "limit": {"type": "integer"}
        },
        "required": ["symbol"]
      }
    },
    {
      "name": "callees",
      "description": "List everything the given symbol calls, with resolution status for each call site.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "symbol": {"type": "string"},
          "limit": {"type": "integer"}
        },
        "required": ["symbol"]
      }
    },
    {
      "name": "deps",
      "description": "List the modules a file or package imports (its dependencies), marking resolved vs external.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "module": {"type": "string", "description": "file path (web/util.ts) or module id (pkg.cart)"},
          "limit": {"type": "integer"}
        },
        "required": ["module"]
      }
    },
    {
      "name": "dependents",
      "description": "List the files/packages that import the given module (reverse dependencies).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "module": {"type": "string"},
          "limit": {"type": "integer"}
        },
        "required": ["module"]
      }
    },
    {
      "name": "search",
      "description": "Full-text search over symbol names, docstrings and signatures stored in the index.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {"type": "string"},
          "limit": {"type": "integer"}
        },
        "required": ["query"]
      }
    },
    {
      "name": "impact",
      "description": "Transitive callers up to a depth: everything that would be affected if the symbol changed.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "symbol": {"type": "string"},
          "depth": {"type": "integer", "default": 3},
          "limit": {"type": "integer"}
        },
        "required": ["symbol"]
      }
    },
    {
      "name": "overview",
      "description": "Index statistics: file/symbol/call/import counts, resolution rates, per-language breakdown.",
      "inputSchema": {"type": "object", "properties": {}}
    },
    {
      "name": "reindex",
      "description": "Refresh the index (incremental by default). Use force=true to re-parse every file.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "force": {"type": "boolean", "default": false}
        }
      }
    }
  ],
  "configSchema": {
    "type": "object",
    "properties": {
      "root": {"type": "string", "description": "project root"},
      "db_path": {"type": "string", "minLength": 1, "description": "index database location (default <root>/.cg/cg.sqlite)"},
      "include": {"type": "array", "items": {"type": "string"}, "description": "if non-empty, only matching paths are indexed"},
      "exclude": {"type": "array", "items": {"type": "string"}, "description": "glob/dir patterns skipped while walking"},
      "max_file_kb": {"type": "integer", "default": 512},
      "incremental": {"type": "boolean", "default": true},
      "engine": {"type": "string", "enum": ["auto", "quick", "deep"], "default": "auto"},
      "language_map": {"type": "object", "additionalProperties": {"type": "string"}}
    }
  },
  "languages": ["python", "javascript", "typescript", "go", "java", "rust"]
}