@pyrokine/mcp-ssh 1.1.2 → 1.2.0

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.
Files changed (43) hide show
  1. package/README.md +3 -1
  2. package/README_zh.md +3 -1
  3. package/dist/file-ops.d.ts +7 -10
  4. package/dist/file-ops.js +74 -172
  5. package/dist/forward-manager.d.ts +33 -0
  6. package/dist/forward-manager.js +185 -0
  7. package/dist/index.js +8 -953
  8. package/dist/pty-manager.d.ts +37 -0
  9. package/dist/pty-manager.js +169 -0
  10. package/dist/session-manager.d.ts +28 -86
  11. package/dist/session-manager.js +131 -441
  12. package/dist/ssh-config.d.ts +0 -4
  13. package/dist/ssh-config.js +1 -8
  14. package/dist/tools/connection.d.ts +7 -0
  15. package/dist/tools/connection.js +215 -0
  16. package/dist/tools/exec.d.ts +8 -0
  17. package/dist/tools/exec.js +221 -0
  18. package/dist/tools/file.d.ts +8 -0
  19. package/dist/tools/file.js +192 -0
  20. package/dist/tools/forward.d.ts +7 -0
  21. package/dist/tools/forward.js +116 -0
  22. package/dist/tools/index.d.ts +8 -0
  23. package/dist/tools/index.js +8 -0
  24. package/dist/tools/pty.d.ts +7 -0
  25. package/dist/tools/pty.js +178 -0
  26. package/dist/tools/utils.d.ts +22 -0
  27. package/dist/tools/utils.js +21 -0
  28. package/dist/types.d.ts +0 -7
  29. package/package.json +3 -2
  30. package/src/file-ops.ts +117 -212
  31. package/src/forward-manager.ts +257 -0
  32. package/src/index.ts +17 -1099
  33. package/src/pty-manager.ts +220 -0
  34. package/src/session-manager.ts +166 -532
  35. package/src/ssh-config.ts +1 -8
  36. package/src/tools/connection.ts +240 -0
  37. package/src/tools/exec.ts +260 -0
  38. package/src/tools/file.ts +219 -0
  39. package/src/tools/forward.ts +141 -0
  40. package/src/tools/index.ts +9 -0
  41. package/src/tools/pty.ts +203 -0
  42. package/src/tools/utils.ts +23 -0
  43. package/src/types.ts +0 -9
@@ -0,0 +1,257 @@
1
+ /**
2
+ * 端口转发管理器
3
+ *
4
+ * 负责本地/远程端口转发的完整生命周期
5
+ */
6
+
7
+ import * as net from 'net'
8
+ import type {Client, ClientChannel} from 'ssh2'
9
+ import type {PortForwardInfo} from './types.js'
10
+
11
+ /** 端口转发所需的外部依赖 */
12
+ export interface ForwardDependencies {
13
+ /** 获取 SSH client */
14
+ getClient(alias: string): Client;
15
+ }
16
+
17
+ interface ForwardSession {
18
+ id: string;
19
+ alias: string;
20
+ type: 'local' | 'remote';
21
+ localHost: string;
22
+ localPort: number;
23
+ remoteHost: string;
24
+ remotePort: number;
25
+ server?: net.Server;
26
+ createdAt: number;
27
+ active: boolean;
28
+ }
29
+
30
+ // tcp connection 事件处理函数类型
31
+ type TcpConnectionHandler = (
32
+ info: { destIP: string; destPort: number; srcIP: string; srcPort: number },
33
+ accept: () => ClientChannel,
34
+ reject: () => void,
35
+ ) => void;
36
+
37
+ /** 每个 SSH session 的 dispatcher 状态 */
38
+ interface DispatcherState {
39
+ handler: TcpConnectionHandler;
40
+ client: Client;
41
+ }
42
+
43
+ export class ForwardManager {
44
+ private sessions: Map<string, ForwardSession> = new Map()
45
+ private dispatchers: Map<string, DispatcherState> = new Map() // alias → dispatcher
46
+ private idCounter = 0
47
+
48
+ async forwardLocal(
49
+ deps: ForwardDependencies,
50
+ alias: string,
51
+ localPort: number,
52
+ remoteHost: string,
53
+ remotePort: number,
54
+ localHost: string = '127.0.0.1',
55
+ ): Promise<string> {
56
+ const client = deps.getClient(alias)
57
+ const forwardId = this.generateId()
58
+
59
+ return new Promise((resolve, reject) => {
60
+ const server = net.createServer((socket) => {
61
+ client.forwardOut(
62
+ socket.remoteAddress || '127.0.0.1',
63
+ socket.remotePort || 0,
64
+ remoteHost,
65
+ remotePort,
66
+ (err, stream) => {
67
+ if (err) {
68
+ socket.end()
69
+ return
70
+ }
71
+ socket.pipe(stream).pipe(socket)
72
+ },
73
+ )
74
+ })
75
+
76
+ server.on('error', (err) => {
77
+ reject(new Error(`Local forward failed: ${err.message}`))
78
+ })
79
+
80
+ server.listen(localPort, localHost, () => {
81
+ this.sessions.set(forwardId, {
82
+ id: forwardId,
83
+ alias,
84
+ type: 'local',
85
+ localHost,
86
+ localPort,
87
+ remoteHost,
88
+ remotePort,
89
+ server,
90
+ createdAt: Date.now(),
91
+ active: true,
92
+ })
93
+ resolve(forwardId)
94
+ })
95
+ })
96
+ }
97
+
98
+ async forwardRemote(
99
+ deps: ForwardDependencies,
100
+ alias: string,
101
+ remotePort: number,
102
+ localHost: string,
103
+ localPort: number,
104
+ remoteHost: string = '127.0.0.1',
105
+ ): Promise<string> {
106
+ const client = deps.getClient(alias)
107
+ const forwardId = this.generateId()
108
+
109
+ return new Promise((resolve, reject) => {
110
+ client.forwardIn(remoteHost, remotePort, (err) => {
111
+ if (err) {
112
+ reject(new Error(`Remote forward failed: ${err.message}`))
113
+ return
114
+ }
115
+
116
+ this.sessions.set(forwardId, {
117
+ id: forwardId,
118
+ alias,
119
+ type: 'remote',
120
+ localHost,
121
+ localPort,
122
+ remoteHost,
123
+ remotePort,
124
+ createdAt: Date.now(),
125
+ active: true,
126
+ })
127
+
128
+ this.ensureTcpDispatcher(alias, client)
129
+ resolve(forwardId)
130
+ })
131
+ })
132
+ }
133
+
134
+ close(forwardId: string, deps?: ForwardDependencies): boolean {
135
+ const fwd = this.sessions.get(forwardId)
136
+ if (!fwd) {
137
+ return false
138
+ }
139
+
140
+ fwd.active = false
141
+
142
+ if (fwd.type === 'local' && fwd.server) {
143
+ try {
144
+ fwd.server.close()
145
+ } catch (e) {
146
+ console.warn(`Forward ${forwardId} server close failed:`, (e as Error).message)
147
+ }
148
+ } else if (fwd.type === 'remote' && deps) {
149
+ try {
150
+ const client = deps.getClient(fwd.alias)
151
+ client.unforwardIn(fwd.remoteHost, fwd.remotePort)
152
+ } catch { /* session 可能已断开 */
153
+ }
154
+ this.removeTcpDispatcherIfEmpty(fwd.alias)
155
+ }
156
+
157
+ this.sessions.delete(forwardId)
158
+ return true
159
+ }
160
+
161
+ /** 关闭指定 alias 的所有转发(disconnect 时调用,不需要 unforwardIn) */
162
+ closeByAlias(alias: string): void {
163
+ for (const [id, fwd] of this.sessions) {
164
+ if (fwd.alias === alias) {
165
+ fwd.active = false
166
+ if (fwd.type === 'local' && fwd.server) {
167
+ try {
168
+ fwd.server.close()
169
+ } catch (e) {
170
+ console.warn(`Forward ${id} server close failed:`, (e as Error).message)
171
+ }
172
+ }
173
+ this.sessions.delete(id)
174
+ }
175
+ }
176
+ // 清理该 alias 的 dispatcher
177
+ const state = this.dispatchers.get(alias)
178
+ if (state) {
179
+ try {
180
+ state.client.removeListener('tcp connection', state.handler)
181
+ } catch { /* client 可能已关闭 */ }
182
+ this.dispatchers.delete(alias)
183
+ }
184
+ }
185
+
186
+ list(): PortForwardInfo[] {
187
+ const result: PortForwardInfo[] = []
188
+ for (const [id, fwd] of this.sessions) {
189
+ result.push({
190
+ id,
191
+ alias: fwd.alias,
192
+ type: fwd.type,
193
+ localHost: fwd.localHost,
194
+ localPort: fwd.localPort,
195
+ remoteHost: fwd.remoteHost,
196
+ remotePort: fwd.remotePort,
197
+ createdAt: fwd.createdAt,
198
+ active: fwd.active,
199
+ })
200
+ }
201
+ return result
202
+ }
203
+
204
+ /**
205
+ * 确保 SSH session 有共享的 tcp connection dispatcher
206
+ * 所有 remote forward 共用一个 dispatcher,根据 destIP/destPort 路由
207
+ */
208
+ private ensureTcpDispatcher(alias: string, client: Client): void {
209
+ if (this.dispatchers.has(alias)) {
210
+ return
211
+ }
212
+
213
+ const handler: TcpConnectionHandler = (info, accept, rejectConn) => {
214
+ for (const fwd of this.sessions.values()) {
215
+ if (fwd.type === 'remote' &&
216
+ fwd.active &&
217
+ fwd.alias === alias &&
218
+ fwd.remoteHost === info.destIP &&
219
+ fwd.remotePort === info.destPort) {
220
+ const stream = accept()
221
+ const socket = net.createConnection(fwd.localPort, fwd.localHost)
222
+ socket.pipe(stream).pipe(socket)
223
+ socket.on('error', () => stream.close())
224
+ stream.on('error', () => socket.destroy())
225
+ return
226
+ }
227
+ }
228
+ rejectConn()
229
+ }
230
+
231
+ this.dispatchers.set(alias, {handler, client})
232
+ client.on('tcp connection', handler)
233
+ }
234
+
235
+ /**
236
+ * 移除 dispatcher(当没有活跃的 remote forward 时)
237
+ */
238
+ private removeTcpDispatcherIfEmpty(alias: string): void {
239
+ const state = this.dispatchers.get(alias)
240
+ if (!state) {
241
+ return
242
+ }
243
+
244
+ for (const fwd of this.sessions.values()) {
245
+ if (fwd.type === 'remote' && fwd.alias === alias && fwd.active) {
246
+ return // 还有活跃的 remote forward
247
+ }
248
+ }
249
+
250
+ state.client.removeListener('tcp connection', state.handler)
251
+ this.dispatchers.delete(alias)
252
+ }
253
+
254
+ private generateId(): string {
255
+ return `fwd_${++this.idCounter}_${Date.now()}`
256
+ }
257
+ }