@subterradb/mcp-server

by epickio.github.epick/subterradb-mcp-serverv0.1.2

How the score works

Model Context Protocol server for SubterraDB — connects Claude Code, Cursor, Windsurf and other MCP clients to a local SubterraDB project so an agent can list tables, run SQL, and inspect project metadata without leaving the editor.

  • Runs on your machine
  • No known advisories
  • MIT

Version checks

  • Available on npm, latest 0.1.2 · checked

Not run yet – package checks are being switched on. It runs from a package on your machine, so instead of uptime we will install and start each new version.

How we check

Run it on your machine

Add to config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows):

{
  "mcpServers": {
    "subterradb-mcp-server": {
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
For agents: the install prompt

Every step above as one Markdown text, for an assistant installing it for you.

# Install the MCP server @subterradb/mcp-server (`io.github.epick/subterradb-mcp-server`)

Its page: https://plug.directory/servers/io.github.epick/subterradb-mcp-server

It runs on the person's machine and needs Node.js installed.

Use the section for the person's client.

## Claude Desktop, Cursor, Devin Desktop, Cline, LM Studio, Gemini CLI, mcp-client-cli, oterm, TUUI, BoltAI, AnythingLLM, Augment Code, Bob Shell, ECA, Kiro, Kiro CLI

Merge into the place for the person's client:

- Claude Desktop: claude_desktop_config.json (Settings › Developer › Edit Config)
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- mcp-client-cli: ~/.llm/config.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- TUUI: resources/assets/config/mcp.json in the installed app
- BoltAI: ~/.boltai/mcp.json
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
- Bob Shell: ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
- Kiro: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)
- Kiro CLI: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)

```json
{
  "mcpServers": {
    "subterradb-mcp-server": {
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
```

## Claude Code

Run in a terminal:

```sh
claude mcp add --transport stdio subterradb-mcp-server -- npx -y @subterradb/mcp-server
```

## VS Code

Merge into .vscode/mcp.json:

```json
{
  "servers": {
    "subterradb-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
```

## Zed

Merge into ~/.config/zed/settings.json:

```json
{
  "context_servers": {
    "subterradb-mcp-server": {
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
```

## Continue

Merge into ~/.continue/config.yaml:

```yaml
mcpServers:
  - name: "subterradb-mcp-server"
    type: stdio
    command: "npx"
    args:
      - "-y"
      - "@subterradb/mcp-server"
```

## Goose

Merge into ~/.config/goose/config.yaml:

```yaml
extensions:
  "subterradb-mcp-server":
    type: stdio
    name: "subterradb-mcp-server"
    enabled: true
    cmd: "npx"
    args: ["-y", "@subterradb/mcp-server"]
    env_keys: []
    envs: {}
    timeout: 300
```

## Codex

Run in a terminal:

```sh
codex mcp add subterradb-mcp-server -- npx -y @subterradb/mcp-server
```

## Agenvoy

Merge into ~/.config/agenvoy/mcp.json:

```json
{
  "servers": {
    "subterradb-mcp-server": {
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
```

## Amp

Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):

```json
{
  "amp.mcpServers": {
    "subterradb-mcp-server": {
      "command": "npx",
      "args": ["-y", "@subterradb/mcp-server"]
    }
  }
}
```

Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.

Known advisories

None known for its packages.

Checked 2026-10-28 against OSV.dev and deps.dev.

From npm. We have not checked this server yet. Report a problem