Commit a80ac05
authored
JITSU-66: MCP tools for syncs, test/debug, and remaining management-API surface (#1385)
Follow-up to #1371 (config CRUD + live events) and the JITSU-66 API-key
auth commits. Implements the remaining tool surface from `JITSU-66`.
## What's added
Three new DI service classes (same pattern as `ConfigObjectsService` /
`EventsLogService`; constructor-injected `prisma` / `pgPool` /
`clickhouse`, shared helpers like `scheduleSync` reused rather than
reimplemented), plus 16 new MCP tools on top of them:
**`SyncService`** (`lib/server/sync-service.ts`, from `sources/*`
routes)
- `run_sync` (with `fullSync` / `ignoreRunning`), `cancel_sync`,
`list_sync_tasks`, `get_sync_logs` (structured rows, ClickHouse with
Postgres fallback — the non-streaming counterpart of `sources/logs.ts`)
- `get_connector_spec`, `discover_streams` — async-poll on the sync
controller; tool descriptions document the poll pattern
- `check_source_credentials` / `get_source_check_result` — the async
`/sources/check` flow, using the service's stored (unmasked) config; the
storage key is derived server-side and workspace-scoped
- `get_sync_state` / `reset_sync_state` (single stream or all; refuses
while the sync is running)
**`DebugService`** (`lib/server/debug-service.ts`, from
`config/[type]/test.ts`, `function/run.ts`, `profile-builder/run.ts`)
- `test_connection` — synchronous bulker `/test`; accepts an existing
object `id` or a full `config` (masked secrets resolved from the stored
object)
- `run_function` / `run_profile_builder` — debug runs on the workspace
functions server; `code`/`settings` default to the stored draft/config
so an agent can exercise what's deployed
**`ReportsService`** (`lib/server/reports-service.ts`, from `reports/*`
+ `profile-builder/stats.ts`)
- `get_event_stat`, `get_sync_stat`, `get_profile_builder_stats`
`registerTools` now also receives the inbound request (scheduleSync
derives the app base URL and EE quota auth from it).
## Tool annotations
All 25 tools (the 9 existing + 16 new) carry standard MCP tool
annotations (`readOnlyHint` / `destructiveHint` / `idempotentHint` /
`openWorldHint`, spec rev 2025-03-26) so clients can skip confirmation
for safe tools and warn on dangerous ones. Without them the spec
defaults make every tool look destructive. The split:
- **read-only** (13): all `list_*` / `get_*` / `query_*` tools
- **safe, repeatable probes** (4): `get_connector_spec`,
`discover_streams`, `check_source_credentials`, `test_connection` —
trigger work but write only internal caches; marked open-world (the
connector contacts the user's source/destination)
- **sandboxed runs** (2): `run_function`, `run_profile_builder` —
persist nothing, but execute user function code (open-world)
- **mutating, non-destructive** (3): `create_resource`, `run_sync`,
`cancel_sync`
- **destructive** (3): `update_resource`, `delete_resource`,
`reset_sync_state`
The annotations also drive runtime behavior: tools not marked read-only
are rejected while maintenance mode is active, mirroring the write block
`createRoute` applies to HTTP routes.
## Tests
No unit tests yet: the console has no harness for testing service
classes against real databases, and mocking prisma/pg is not worth it.
`JITSU-90` tracks a testcontainers-based harness (real Postgres +
ClickHouse); tests for these services will come with it. The existing
console suite passes (49).
The HTTP routes are intentionally untouched — migrating them onto these
services is `JITSU-91`.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_01L3JqeGCtMegoGyVMrwT8Pa5 files changed
Lines changed: 1343 additions & 14 deletions
File tree
- webapps/console/lib/server
- mcp-server
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 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 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
| 208 | + | |
| 209 | + | |
| 210 | + | |
| 211 | + | |
| 212 | + | |
| 213 | + | |
| 214 | + | |
| 215 | + | |
| 216 | + | |
| 217 | + | |
| 218 | + | |
| 219 | + | |
| 220 | + | |
| 221 | + | |
| 222 | + | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| 228 | + | |
| 229 | + | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
| 241 | + | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | + | |
| 246 | + | |
| 247 | + | |
| 248 | + | |
| 249 | + | |
| 250 | + | |
| 251 | + | |
| 252 | + | |
| 253 | + | |
| 254 | + | |
| 255 | + | |
| 256 | + | |
| 257 | + | |
| 258 | + | |
| 259 | + | |
| 260 | + | |
| 261 | + | |
| 262 | + | |
| 263 | + | |
| 264 | + | |
| 265 | + | |
| 266 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
12 | 13 | | |
13 | 14 | | |
14 | 15 | | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
15 | 19 | | |
16 | 20 | | |
17 | 21 | | |
| |||
22 | 26 | | |
23 | 27 | | |
24 | 28 | | |
25 | | - | |
| 29 | + | |
26 | 30 | | |
| 31 | + | |
| 32 | + | |
27 | 33 | | |
28 | 34 | | |
29 | 35 | | |
| |||
41 | 47 | | |
42 | 48 | | |
43 | 49 | | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
44 | 53 | | |
45 | 54 | | |
46 | 55 | | |
| |||
51 | 60 | | |
52 | 61 | | |
53 | 62 | | |
54 | | - | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
55 | 69 | | |
56 | 70 | | |
57 | 71 | | |
| |||
75 | 89 | | |
76 | 90 | | |
77 | 91 | | |
78 | | - | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
79 | 100 | | |
80 | 101 | | |
81 | 102 | | |
| |||
0 commit comments