sh-layer4 1.0.0

Continuum Layer 4: Integration
Documentation
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
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
//! MCP 客户端管理器
//!
//! 管理多个 MCP 服务器连接。
//!
//! 支持真实的 stdio 和 TCP 连接,完整 MCP 协议握手。

use super::protocol::{McpMessage, McpRequest, RequestId, ToolDefinition, ToolResult};
#[cfg(unix)]
use super::transport::UnixSocketTransport;
use super::transport::{McpTransport, McpTransportType, StdioTransport, TcpTransport};
use anyhow::{anyhow, Result};
use parking_lot::RwLock as ParkingRwLock;
use serde_json::Value;
use std::collections::HashMap;
use std::sync::atomic::{AtomicU64, Ordering};
use std::sync::Arc;
use tracing::{debug, info, warn};

/// MCP 服务器配置
#[derive(Debug, Clone)]
pub struct McpServerConfig {
    /// 服务器名称
    pub name: String,
    /// 传输类型
    pub transport: McpTransportType,
    /// 自动重连
    pub auto_reconnect: bool,
    /// 重连间隔 (毫秒)
    pub reconnect_interval_ms: u64,
}

/// 已连接的 MCP 服务器
struct ConnectedServer {
    #[allow(dead_code)]
    config: McpServerConfig,
    transport: Arc<dyn McpTransport>,
    tools: Vec<ToolDefinition>,
}

/// MCP 客户端管理器
pub struct McpClientManager {
    /// 服务器配置
    configs: ParkingRwLock<HashMap<String, McpServerConfig>>,
    /// 已连接的服务器
    servers: ParkingRwLock<HashMap<String, ConnectedServer>>,
    /// 工具到服务器的映射
    tool_mapping: ParkingRwLock<HashMap<String, String>>,
    /// 请求 ID 计数器
    request_id_counter: AtomicU64,
}

impl Default for McpClientManager {
    fn default() -> Self {
        Self::new()
    }
}

impl McpClientManager {
    /// 创建新的管理器
    pub fn new() -> Self {
        Self {
            configs: ParkingRwLock::new(HashMap::new()),
            servers: ParkingRwLock::new(HashMap::new()),
            tool_mapping: ParkingRwLock::new(HashMap::new()),
            request_id_counter: AtomicU64::new(1),
        }
    }

    /// 生成下一个请求 ID
    fn next_request_id(&self) -> RequestId {
        RequestId::Number(self.request_id_counter.fetch_add(1, Ordering::SeqCst) as i64)
    }

    /// 添加服务器配置
    pub async fn add_server(&self, config: McpServerConfig) -> Result<()> {
        let name = config.name.clone();
        let mut configs = self.configs.write();
        configs.insert(name, config);
        Ok(())
    }

    /// 连接到服务器
    pub async fn connect(&self, name: &str) -> Result<()> {
        let config = {
            let configs = self.configs.read();
            configs
                .get(name)
                .ok_or_else(|| anyhow!("Server not found: {}", name))?
                .clone()
        };

        info!(server = %name, transport = ?config.transport, "Connecting to MCP server");

        // 根据传输类型创建真实连接
        let transport: Arc<dyn McpTransport> = match &config.transport {
            McpTransportType::Stdio { command, args } => {
                // 创建真实的 Stdio 传输
                let stdio_transport = StdioTransport::new(command, args)?;
                stdio_transport.start(command, args).await?;
                info!(server = %name, command = %command, "Stdio transport started");
                Arc::new(stdio_transport)
            }
            McpTransportType::Tcp { addr } => {
                // 创建真实的 TCP 连接
                let tcp_transport = TcpTransport::connect(addr).await?;
                info!(server = %name, addr = %addr, "TCP transport connected");
                Arc::new(tcp_transport)
            }
            #[cfg(unix)]
            McpTransportType::Unix { path } => {
                // 创建真实的 Unix socket 连接
                let unix_transport = UnixSocketTransport::connect(path).await?;
                info!(server = %name, path = %path, "Unix socket transport connected");
                Arc::new(unix_transport)
            }
        };

        // 发送初始化请求(MCP 协议握手第一步)
        let init_params = serde_json::json!({
            "protocolVersion": "2024-11-05",
            "capabilities": {
                "roots": {
                    "listChanged": true
                },
                "sampling": {}
            },
            "clientInfo": {
                "name": "continuum",
                "version": env!("CARGO_PKG_VERSION")
            }
        });

        let request = McpRequest {
            id: self.next_request_id(),
            method: "initialize".to_string(),
            params: Some(init_params),
        };

        debug!(server = %name, "Sending initialize request");
        transport.send(&McpMessage::Request(request)).await?;

        // 等待响应(带超时处理)
        let response =
            tokio::time::timeout(std::time::Duration::from_secs(30), transport.receive())
                .await
                .map_err(|_| anyhow!("Initialize timeout for server: {}", name))??;

        match response {
            Some(McpMessage::Response(response)) => {
                if let Some(error) = &response.error {
                    warn!(server = %name, code = ?error.code, message = %error.message, "Initialize failed");
                    return Err(anyhow!(
                        "Initialize failed (code {}): {}",
                        error.code,
                        error.message
                    ));
                }

                // 记录服务器能力
                if let Some(result) = &response.result {
                    debug!(server = %name, result = ?result, "Server capabilities received");
                    if let Some(server_info) = result.get("serverInfo") {
                        info!(server = %name, server_info = ?server_info, "Connected to MCP server");
                    }
                }
            }
            Some(McpMessage::Error(error)) => {
                warn!(server = %name, error = ?error, "Received error response");
                return Err(anyhow!("Server error: {:?}", error));
            }
            Some(other) => {
                warn!(server = %name, message = ?other, "Unexpected message type");
                return Err(anyhow!("Unexpected response type during initialization"));
            }
            None => {
                warn!(server = %name, "No response received");
                return Err(anyhow!("No response from server during initialization"));
            }
        }

        // 发送 initialized 通知(MCP 协议握手第二步)
        let notification = McpMessage::Notification(super::protocol::McpNotification {
            method: "notifications/initialized".to_string(),
            params: None,
        });
        transport.send(&notification).await?;
        debug!(server = %name, "Sent initialized notification");

        // 列出可用工具
        let list_tools_request = McpRequest {
            id: self.next_request_id(),
            method: "tools/list".to_string(),
            params: None,
        };
        transport
            .send(&McpMessage::Request(list_tools_request))
            .await?;

        let tools_response =
            tokio::time::timeout(std::time::Duration::from_secs(10), transport.receive())
                .await
                .map_err(|_| anyhow!("Tools list timeout for server: {}", name))??;

        let tools = match tools_response {
            Some(McpMessage::Response(response)) => {
                if let Some(result) = &response.result {
                    if let Some(tools_array) = result.get("tools") {
                        match serde_json::from_value::<Vec<ToolDefinition>>(tools_array.clone()) {
                            Ok(t) => {
                                info!(server = %name, tool_count = t.len(), "Tools discovered");
                                t
                            }
                            Err(e) => {
                                warn!(server = %name, error = %e, "Failed to parse tools");
                                Vec::new()
                            }
                        }
                    } else {
                        Vec::new()
                    }
                } else {
                    Vec::new()
                }
            }
            _ => Vec::new(),
        };

        // 更新服务器状态
        let mut servers = self.servers.write();
        servers.insert(
            name.to_string(),
            ConnectedServer {
                config,
                transport,
                tools,
            },
        );

        info!(server = %name, "MCP connection established successfully");
        Ok(())
    }

    /// 连接所有服务器
    pub async fn connect_all(&self) -> Result<Vec<String>> {
        let names: Vec<String> = self.configs.read().keys().cloned().collect();
        let mut results = Vec::new();

        for name in &names {
            if self.connect(name).await.is_ok() {
                results.push(name.clone());
            }
        }

        Ok(results)
    }

    /// 断开服务器连接
    pub async fn disconnect(&self, name: &str) -> Result<()> {
        let server = {
            let mut servers = self.servers.write();
            servers.remove(name)
        };
        if let Some(s) = server {
            s.transport.close().await?;
        }
        Ok(())
    }

    /// 获取服务器状态
    pub fn get_server_status(&self, name: &str) -> Option<bool> {
        let servers = self.servers.read();
        servers.get(name).map(|_| true)
    }

    /// 列出所有服务器
    pub fn list_servers(&self) -> Vec<(String, bool)> {
        let servers = self.servers.read();
        let configs = self.configs.read();

        let mut result = Vec::new();
        for name in configs.keys() {
            let connected = servers.contains_key(name);
            result.push((name.clone(), connected));
        }
        result
    }

    /// 获取所有可用工具
    pub fn list_all_tools(&self) -> Vec<(String, ToolDefinition)> {
        let servers = self.servers.read();
        let mut tools = Vec::new();

        for (server_name, server) in servers.iter() {
            for tool in &server.tools {
                tools.push((server_name.clone(), tool.clone()));
            }
        }

        tools
    }

    /// 调用工具
    pub async fn call_tool(&self, tool_name: &str, arguments: Value) -> Result<ToolResult> {
        // 查找工具所在的服务器
        let server_name = {
            let tool_mapping = self.tool_mapping.read();
            tool_mapping
                .get(tool_name)
                .ok_or_else(|| anyhow!("Tool not found: {}", tool_name))?
                .clone()
        };

        // 获取服务器和传输层
        let (transport, request_id) = {
            let servers = self.servers.read();
            let server = servers
                .get(&server_name)
                .ok_or_else(|| anyhow!("Server not found: {}", server_name))?;

            (server.transport.clone(), self.next_request_id())
        };

        // 构建请求
        let params = serde_json::json!({
            "name": tool_name,
            "arguments": arguments
        });

        let request = McpRequest {
            id: request_id,
            method: "tools/call".to_string(),
            params: Some(params),
        };

        // 发送请求
        transport.send(&McpMessage::Request(request)).await?;

        // 接收响应
        match transport.receive().await? {
            Some(McpMessage::Response(response)) => {
                if let Some(error) = response.error {
                    return Err(anyhow!("Tool call error: {}", error.message));
                }

                if let Some(result) = response.result {
                    let tool_result: ToolResult =
                        serde_json::from_value(result).unwrap_or_else(|_| ToolResult {
                            is_error: false,
                            content: vec![super::protocol::ContentBlock::Text {
                                text: "Tool executed successfully".to_string(),
                            }],
                        });
                    Ok(tool_result)
                } else {
                    Err(anyhow!("Empty response"))
                }
            }
            Some(McpMessage::Error(error)) => Err(anyhow!("Error: {:?}", error)),
            _ => Err(anyhow!("Unexpected response type")),
        }
    }

    /// 注册工具到服务器
    pub async fn register_tools(
        &self,
        server_name: &str,
        tools: Vec<ToolDefinition>,
    ) -> Result<()> {
        let mut servers = self.servers.write();
        let server = servers
            .get_mut(server_name)
            .ok_or_else(|| anyhow!("Server not found: {}", server_name))?;

        let mut tool_mapping = self.tool_mapping.write();
        for tool in &tools {
            tool_mapping.insert(tool.name.clone(), server_name.to_string());
        }

        server.tools = tools;
        Ok(())
    }

    /// 渲染服务器列表
    pub fn render_status(&self) -> String {
        let servers = self.servers.read();
        let configs = self.configs.read();
        let mut output = String::new();

        output.push_str("MCP Servers:\n");

        if configs.is_empty() {
            output.push_str("  No servers configured\n");
        } else {
            for name in configs.keys() {
                let server = servers.get(name);
                let status = if server.is_some() { "🟢" } else { "🔴" };
                let tool_count = server.map(|s| s.tools.len()).unwrap_or(0);
                output.push_str(&format!("  {} {} ({} tools)\n", status, name, tool_count));
            }
        }

        output
    }
}

/// 预设的 MCP 服务器配置
pub fn preset_servers() -> Vec<McpServerConfig> {
    vec![
        // 文件系统 MCP
        McpServerConfig {
            name: "filesystem".to_string(),
            transport: McpTransportType::Stdio {
                command: "mcp-server-filesystem".to_string(),
                args: vec!["--root".to_string(), ".".to_string()],
            },
            auto_reconnect: true,
            reconnect_interval_ms: 5000,
        },
        // GitHub MCP
        McpServerConfig {
            name: "github".to_string(),
            transport: McpTransportType::Stdio {
                command: "mcp-server-github".to_string(),
                args: vec![],
            },
            auto_reconnect: true,
            reconnect_interval_ms: 5000,
        },
        // Playwright MCP - 浏览器自动化
        McpServerConfig {
            name: "playwright".to_string(),
            transport: McpTransportType::Stdio {
                command: "npx".to_string(),
                args: vec![
                    "@playwright/mcp@latest".to_string(),
                    "--headless".to_string(),
                    "--browser".to_string(),
                    "chrome".to_string(),
                ],
            },
            auto_reconnect: true,
            reconnect_interval_ms: 5000,
        },
    ]
}

#[cfg(test)]
mod tests {
    use super::*;

    #[tokio::test]
    async fn test_manager_creation() {
        let manager = McpClientManager::new();
        let servers = manager.list_servers();
        assert!(servers.is_empty());
    }

    #[tokio::test]
    async fn test_add_server() {
        let manager = McpClientManager::new();

        let config = McpServerConfig {
            name: "test".to_string(),
            transport: McpTransportType::Stdio {
                command: "test-command".to_string(),
                args: vec![],
            },
            auto_reconnect: false,
            reconnect_interval_ms: 1000,
        };

        manager.add_server(config).await.unwrap();
        let servers = manager.list_servers();
        assert_eq!(servers.len(), 1);
        assert_eq!(servers[0].0, "test");
        assert!(!servers[0].1); // 未连接
    }

    #[test]
    fn test_preset_servers() {
        let presets = preset_servers();
        assert!(!presets.is_empty());
        assert!(presets.iter().any(|s| s.name == "filesystem"));
        assert!(presets.iter().any(|s| s.name == "github"));
    }

    #[test]
    fn test_request_id_generation() {
        let manager = McpClientManager::new();
        let id1 = manager.next_request_id();
        let id2 = manager.next_request_id();
        assert_ne!(id1, id2);
    }
}