vault-cortex/server.json at main · aliasunder/vault-cortex · 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
120
121
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.aliasunder/vault-cortex",
  "title": "vault-cortex",
  "description": "MCP server for Obsidian vaults — search, memory, link graph, 23 tools, OAuth-protected.",
  "version": "0.15.9",
  "websiteUrl": "https://github.com/aliasunder/vault-cortex",
  "repository": {
    "url": "https://github.com/aliasunder/vault-cortex",
    "source": "github",
    "id": "1226067541"
  },
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/aliasunder/vault-mcp:0.15.9",
      "runtimeHint": "docker",
      "runtimeArguments": [
        {
          "type": "named",
          "name": "-p",
          "description": "Publish the container's port 8000 on the host.",
          "value": "8000:8000"
        },
        {
          "type": "named",
          "name": "-v",
          "description": "Bind-mount your Obsidian vault into the container at /vault.",
          "value": "{VAULT_PATH}:/vault:rw",
          "isRequired": true,
          "variables": {
            "VAULT_PATH": {
              "description": "Absolute path to your Obsidian vault on the host machine.",
              "isRequired": true,
              "format": "filepath"
            }
          }
        },
        {
          "type": "named",
          "name": "-v",
          "description": "Named volume for persistent state under /data — search index, OAuth token DB, and any log files. Keeps OAuth sessions alive across container restarts.",
          "value": "vault-cortex-data:/data"
        }
      ],
      "transport": {
        "type": "streamable-http",
        "url": "http://localhost:8000/mcp",
        "headers": [
          {
            "name": "Authorization",
            "description": "Bearer token used by the MCP client. Must match the MCP_AUTH_TOKEN env var passed to the container.",
            "value": "Bearer {MCP_AUTH_TOKEN}",
            "isRequired": true,
            "isSecret": true,
            "variables": {
              "MCP_AUTH_TOKEN": {
                "description": "Bearer token for MCP client authentication. Generate with: openssl rand -hex 32",
                "isRequired": true,
                "isSecret": true
              }
            }
          }
        ]
      },
      "environmentVariables": [
        {
          "name": "MCP_AUTH_TOKEN",
          "description": "Bearer token for MCP client authentication. Must match the Authorization header sent by clients. Generate with: openssl rand -hex 32",
          "isRequired": true,
          "isSecret": true
        },
        {
          "name": "PUBLIC_URL",
          "description": "Public URL clients use to reach this server. Used as the OAuth issuer URL in discovery metadata. Override when exposing the server outside localhost or on a non-default port.",
          "default": "http://localhost:8000"
        },
        {
          "name": "MEMORY_DIR",
          "description": "Vault folder for structured memory files (About Me-style notes).",
          "default": "About Me"
        },
        {
          "name": "TZ",
          "description": "IANA timezone for timestamps and daily note resolution.",
          "default": "UTC"
        },
        {
          "name": "LOG_LEVEL",
          "description": "Logging verbosity.",
          "default": "info",
          "choices": ["debug", "info", "warn", "error"]
        },
        {
          "name": "LOG_DIR",
          "description": "Directory for persistent log files. Unset by default — logs go to stdout only. Set to /data/logs to also write date-stamped .log files to the persistent volume.",
          "format": "filepath"
        },
        {
          "name": "LOG_RETENTION_DAYS",
          "description": "Days to retain persistent log files before cleanup.",
          "default": "30",
          "format": "number"
        },
        {
          "name": "PROTECTED_PATHS",
          "description": "Comma-separated vault folder names blocked from vault_delete_note. Default: MEMORY_DIR and \"Daily Notes\"."
        },
        {
          "name": "ORPHAN_EXCLUDE_FOLDERS",
          "description": "Comma-separated vault folder names excluded from vault_find_orphans. Default: \"Daily Notes\", \"Templates\", MEMORY_DIR."
        },
        {
          "name": "SERVICE_DOCUMENTATION_URL",
          "description": "Override the OAuth service documentation URL exposed via discovery metadata.",
          "default": "https://github.com/aliasunder/vault-cortex"
        }
      ]
    }
  ]
}