@ecubelabs/mysql-mcp 1.0.0-next.5 → 1.0.0-next.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -57,6 +57,7 @@ Host ecubelabs2-prod-db
57
57
 
58
58
  ```bash
59
59
  ssh ecubelabs2-stage-db "echo ok"
60
+ ssh ecubelabs2-prod-db "echo ok"
60
61
  ```
61
62
 
62
63
  - alias가 동작하는지 확인합니다.
@@ -110,8 +111,10 @@ codex mcp add mysql-prod \
110
111
 
111
112
  ```text
112
113
  mysql-stage catalog의 table을 model.md 문서와 모두 연결해줘
114
+ mysql-prod catalog의 table을 model.md 문서와 모두 연결해줘
113
115
  ```
114
116
 
117
+ - Catalog는 profile마다 따로 있으므로 연결도 profile마다 합니다.
115
118
  - 모델이 저장소에서 문서를 찾아 저장소 기준 상대 경로와 GitHub 저장소(`owner/name`)로
116
119
  기록합니다. 서버는 파일이 있는지 확인하지 않습니다.
117
120
  - Branch가 기록되지 않은 저장소를 연결하면 `link` 응답이 그 저장소의 branch를 묻게
@@ -132,8 +135,11 @@ Profile 이름으로 물어보면 답변에 환경이 함께 돌아옵니다:
132
135
 
133
136
  ```text
134
137
  stage db에 Active Account가 몇 개 있는지 알려줘
138
+ prod db에 Active Account가 몇 개 있는지 알려줘
135
139
  ```
136
140
 
141
+ stage 응답:
142
+
137
143
  ```text
138
144
  [profile: STAGE | read-only | database: multi-db | code: Ecube-Labs/haulla@develop | ssh tunnel: dev@<stage bastion 호스트명> -> <stage RDS reader 엔드포인트>:3306]
139
145
  [
@@ -143,6 +149,12 @@ stage db에 Active Account가 몇 개 있는지 알려줘
143
149
  ]
144
150
  ```
145
151
 
152
+ prod 응답의 banner:
153
+
154
+ ```text
155
+ [profile: PROD | READ-ONLY (enforced) | database: multi-db | code: Ecube-Labs/haulla@main | ssh tunnel: dev@<prod bastion 호스트명> -> <prod RDS reader 엔드포인트>:3306]
156
+ ```
157
+
146
158
  - 모든 툴 응답이 성공이든 거부든 이 banner를 달고 나오므로, stage 결과를 prod
147
159
  결과로 착각할 수 없습니다.
148
160
  - `mysql_query` 툴 설명에도 환경 이름이 들어갑니다. 모델이 툴을 고르기 전에 읽는
@@ -175,6 +187,7 @@ stage db에 Active Account가 몇 개 있는지 알려줘
175
187
 
176
188
  ```text
177
189
  mysql-stage의 haulla schema는 Ecube-Labs/haulla의 core-api 것이야. owner로 기록해줘
190
+ mysql-prod의 haulla schema는 Ecube-Labs/haulla의 core-api 것이야. owner로 기록해줘
178
191
  ```
179
192
 
180
193
  - 기록된 owner는 `map`의 schema마다, `search` 결과의 table마다, `describe`,
@@ -455,6 +468,8 @@ Catalog에는 schema metadata와 사용 기록만 들어갑니다.
455
468
  `ALLOW_*`로 판정합니다.
456
469
  - 그래서 `ALLOW_UPDATE_OPERATION`을 끈 채 `SCHEMA_UPDATE_PERMISSIONS=haulla:true`만 적으면
457
470
  `haulla`에서만 UPDATE가 열립니다.
471
+ - `false`는 대소문자를 가리지 않고 맞춥니다. `haulla:false`면 `HAULLA`도 거부합니다.
472
+ `true`는 적은 철자와 같은 이름에만 적용되고, 철자가 다르면 `ALLOW_*`로 판정합니다.
458
473
  - 쓰기가 하나라도 열리면 도구 설명에 `with support for: UPDATE (haulla only) …`처럼 적고
459
474
  `readOnlyHint`를 `false`로 알립니다.
460
475
 
@@ -569,8 +584,10 @@ Forwarding은 `ssh -N -L`을 spawn 하는 대신 `ssh2`를 통해 프로세스
569
584
  `known_hosts`를 읽지 않고, 검증하지 않으면 어떤 키든 받습니다. 그러면 경로 위의
570
585
  공격자가 bastion을 사칭해 DB 비밀번호를 받아 갈 수 있습니다.
571
586
  - alias의 `UserKnownHostsFile`(없으면 `~/.ssh/known_hosts`, `~/.ssh/known_hosts2`)와
572
- `/etc/ssh/ssh_known_hosts`를 읽습니다. alias에 `HostKeyAlias`가 있으면 그 이름으로
573
- 찾습니다.
587
+ `/etc/ssh/ssh_known_hosts`를 읽습니다.
588
+ - 찾는 이름은 OpenSSH와 같습니다. alias에 `HostKeyAlias`가 있으면 포트를 붙이지 않고 그
589
+ 이름 그대로 찾습니다. 없으면 호스트 이름을 소문자로 바꾸고, 22번이 아닌 포트는
590
+ `[host]:port`로 찾습니다.
574
591
  - 기록된 키 종류로만 협상합니다. 처음 보는 호스트는 기록하지 않고 거부합니다. 지문을
575
592
  확인할 수 있는 `ssh`로 한 번 접속해 기록하세요.
576
593
  - `@cert-authority` 인증서 기반 호스트 키는 지원하지 않습니다.
@@ -1,27 +1,43 @@
1
1
  import { ALLOW_DELETE_OPERATION, ALLOW_DDL_OPERATION, ALLOW_INSERT_OPERATION, ALLOW_UPDATE_OPERATION, SCHEMA_DELETE_PERMISSIONS, SCHEMA_DDL_PERMISSIONS, SCHEMA_INSERT_PERMISSIONS, SCHEMA_UPDATE_PERMISSIONS, } from '../config/index.js';
2
+ function schemaOverride(permissions, schema) {
3
+ const lowered = schema.toLowerCase();
4
+ let override;
5
+ for (const [name, allowed] of Object.entries(permissions)) {
6
+ if (name.toLowerCase() !== lowered) {
7
+ continue;
8
+ }
9
+ if (!allowed) {
10
+ return false;
11
+ }
12
+ if (name === schema) {
13
+ override = true;
14
+ }
15
+ }
16
+ return override;
17
+ }
2
18
  function isInsertAllowedForSchema(schema) {
3
19
  if (!schema) {
4
20
  return ALLOW_INSERT_OPERATION;
5
21
  }
6
- return schema in SCHEMA_INSERT_PERMISSIONS ? SCHEMA_INSERT_PERMISSIONS[schema] : ALLOW_INSERT_OPERATION;
22
+ return schemaOverride(SCHEMA_INSERT_PERMISSIONS, schema) ?? ALLOW_INSERT_OPERATION;
7
23
  }
8
24
  function isUpdateAllowedForSchema(schema) {
9
25
  if (!schema) {
10
26
  return ALLOW_UPDATE_OPERATION;
11
27
  }
12
- return schema in SCHEMA_UPDATE_PERMISSIONS ? SCHEMA_UPDATE_PERMISSIONS[schema] : ALLOW_UPDATE_OPERATION;
28
+ return schemaOverride(SCHEMA_UPDATE_PERMISSIONS, schema) ?? ALLOW_UPDATE_OPERATION;
13
29
  }
14
30
  function isDeleteAllowedForSchema(schema) {
15
31
  if (!schema) {
16
32
  return ALLOW_DELETE_OPERATION;
17
33
  }
18
- return schema in SCHEMA_DELETE_PERMISSIONS ? SCHEMA_DELETE_PERMISSIONS[schema] : ALLOW_DELETE_OPERATION;
34
+ return schemaOverride(SCHEMA_DELETE_PERMISSIONS, schema) ?? ALLOW_DELETE_OPERATION;
19
35
  }
20
36
  function isDDLAllowedForSchema(schema) {
21
37
  if (!schema) {
22
38
  return ALLOW_DDL_OPERATION;
23
39
  }
24
- return schema in SCHEMA_DDL_PERMISSIONS ? SCHEMA_DDL_PERMISSIONS[schema] : ALLOW_DDL_OPERATION;
40
+ return schemaOverride(SCHEMA_DDL_PERMISSIONS, schema) ?? ALLOW_DDL_OPERATION;
25
41
  }
26
42
  function writeCapabilities() {
27
43
  const kinds = [
@@ -36,7 +52,7 @@ function writeCapabilities() {
36
52
  capabilities.push({ label, schemas: null });
37
53
  continue;
38
54
  }
39
- const opened = Object.keys(perSchema).filter((schema) => perSchema[schema]);
55
+ const opened = Object.keys(perSchema).filter((schema) => schemaOverride(perSchema, schema) === true);
40
56
  if (opened.length > 0) {
41
57
  capabilities.push({ label, schemas: opened });
42
58
  }
@@ -3,8 +3,12 @@ import * as fs from 'fs';
3
3
  import { expandHome } from './config.js';
4
4
  export const DEFAULT_USER_KNOWN_HOSTS_FILES = ['~/.ssh/known_hosts', '~/.ssh/known_hosts2'];
5
5
  const GLOBAL_KNOWN_HOSTS_FILES = ['/etc/ssh/ssh_known_hosts', '/etc/ssh/ssh_known_hosts2'];
6
- export function knownHostsName(host, port) {
7
- return port === 22 ? host : `[${host}]:${port}`;
6
+ export function knownHostsName(host, port, hostKeyAlias) {
7
+ if (hostKeyAlias) {
8
+ return hostKeyAlias;
9
+ }
10
+ const lowered = host.toLowerCase();
11
+ return port === 22 ? lowered : `[${lowered}]:${port}`;
8
12
  }
9
13
  function matchesWildcard(pattern, name) {
10
14
  const source = pattern
@@ -38,8 +42,7 @@ function hostFieldMatches(field, name) {
38
42
  }
39
43
  return matched;
40
44
  }
41
- export function lookupKnownHosts(host, port, files) {
42
- const name = knownHostsName(host, port);
45
+ export function lookupKnownHosts(name, files) {
43
46
  const result = { name, files: [], keys: [], revoked: [] };
44
47
  for (const file of [...files.map(expandHome), ...GLOBAL_KNOWN_HOSTS_FILES]) {
45
48
  let raw;
@@ -4,7 +4,7 @@ import { Client as SSHClient } from 'ssh2';
4
4
  import { MYSQL_HOST, MYSQL_PORT, SSH_CONFIG_HOST, SSH_ENABLED, SSH_HOST, SSH_LOCAL_PORT, SSH_PASSPHRASE, SSH_PORT, SSH_PRIVATE_KEY_PATH, SSH_REUSE_EXISTING, SSH_USER, } from '../config/index.js';
5
5
  import { log } from '../utils/index.js';
6
6
  import { expandHome, readSSHConfigHost } from './config.js';
7
- import { DEFAULT_USER_KNOWN_HOSTS_FILES, hostKeyAlgorithms, isKnownHostKey, lookupKnownHosts } from './known-hosts.js';
7
+ import { DEFAULT_USER_KNOWN_HOSTS_FILES, hostKeyAlgorithms, isKnownHostKey, knownHostsName, lookupKnownHosts, } from './known-hosts.js';
8
8
  class LocalPortTakenError extends Error {
9
9
  }
10
10
  const RECONNECT_MAX_ATTEMPTS = 3;
@@ -63,7 +63,7 @@ export function resolveTunnelConfig() {
63
63
  privateKeyPath,
64
64
  passphrase: SSH_PASSPHRASE,
65
65
  knownHostsFiles: fromConfig?.userKnownHostsFiles ?? DEFAULT_USER_KNOWN_HOSTS_FILES,
66
- hostKeyName: fromConfig?.hostKeyAlias ?? sshHost,
66
+ hostKeyName: knownHostsName(sshHost, sshPort, fromConfig?.hostKeyAlias),
67
67
  sshTarget: configHost ?? `${sshPort === 22 ? '' : `-p ${sshPort} `}${sshUser}@${sshHost}`,
68
68
  localPort,
69
69
  remoteHost: remoteHost,
@@ -99,7 +99,7 @@ let shuttingDown = false;
99
99
  let fatalError = null;
100
100
  function connectSSH(cfg) {
101
101
  return new Promise((resolve, reject) => {
102
- const known = lookupKnownHosts(cfg.hostKeyName, cfg.sshPort, cfg.knownHostsFiles);
102
+ const known = lookupKnownHosts(cfg.hostKeyName, cfg.knownHostsFiles);
103
103
  const algorithms = hostKeyAlgorithms(known.keys);
104
104
  if (algorithms.length === 0) {
105
105
  const searched = known.files.length > 0 ? known.files.join(', ') : cfg.knownHostsFiles.join(', ');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ecubelabs/mysql-mcp",
3
- "version": "1.0.0-next.5",
3
+ "version": "1.0.0-next.6",
4
4
  "description": "Read-only MySQL MCP server that reaches its database through an SSH bastion, with per-environment profiles",
5
5
  "license": "MIT",
6
6
  "repository": {