use serde::{Deserialize, Serialize}; use serde_json::{Map, Value}; use std::env; use std::fs; use std::path::{Path, PathBuf}; use crate::config::{atomic_write, get_claude_mcp_path, get_default_claude_mcp_path}; use crate::error::AppError; /// 需要在 Windows 上用 cmd /c 包装的命令 /// 这些命令在 Windows 上实际是 .cmd 批处理文件,需要通过 cmd /c 来执行 #[cfg(windows)] const WINDOWS_WRAP_COMMANDS: &[&str] = &["npx", "npm", "yarn", "pnpm", "node", "bun", "deno"]; /// Windows 平台:将 `npx args...` 转换为 `cmd /c npx args...` /// 解决 Claude Code /doctor 报告的 "Windows requires 'cmd /c' wrapper to execute npx" 警告 #[cfg(windows)] fn wrap_command_for_windows(obj: &mut Map) { // 只处理 stdio 类型(默认或显式) let server_type = obj.get("type").and_then(|v| v.as_str()).unwrap_or("stdio"); if server_type != "stdio" { return; } let Some(cmd) = obj.get("command").and_then(|v| v.as_str()) else { return; }; // 已经是 cmd 的不重复包装 if cmd.eq_ignore_ascii_case("cmd") || cmd.eq_ignore_ascii_case("cmd.exe") { return; } // 提取命令名(去掉 .cmd 后缀和路径) let cmd_name = Path::new(cmd) .file_stem() .and_then(|s| s.to_str()) .unwrap_or(cmd); let needs_wrap = WINDOWS_WRAP_COMMANDS .iter() .any(|&c| cmd_name.eq_ignore_ascii_case(c)); if !needs_wrap { return; } // 构建新的 args: ["/c", "原命令", ...原args] let original_args = obj .get("args") .and_then(|v| v.as_array()) .cloned() .unwrap_or_default(); let mut new_args = vec![Value::String("/c".into()), Value::String(cmd.into())]; new_args.extend(original_args); obj.insert("command".into(), Value::String("cmd".into())); obj.insert("args".into(), Value::Array(new_args)); } /// 非 Windows 平台无需处理 #[cfg(not(windows))] fn wrap_command_for_windows(_obj: &mut Map) { // 非 Windows 平台不做任何处理 } #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct McpStatus { pub user_config_path: String, pub user_config_exists: bool, pub server_count: usize, } fn user_config_path() -> PathBuf { ensure_mcp_override_migrated(); get_claude_mcp_path() } fn ensure_mcp_override_migrated() { if crate::settings::get_claude_override_dir().is_none() { return; } let new_path = get_claude_mcp_path(); if new_path.exists() { return; } let legacy_path = get_default_claude_mcp_path(); if !legacy_path.exists() { return; } if let Some(parent) = new_path.parent() { if let Err(err) = fs::create_dir_all(parent) { log::warn!("创建 MCP 目录失败: {err}"); return; } } match fs::copy(&legacy_path, &new_path) { Ok(_) => { log::info!( "已根据覆盖目录复制 MCP 配置: {} -> {}", legacy_path.display(), new_path.display() ); } Err(err) => { log::warn!( "复制 MCP 配置失败: {} -> {}: {}", legacy_path.display(), new_path.display(), err ); } } } fn read_json_value(path: &Path) -> Result { if !path.exists() { return Ok(serde_json::json!({})); } let content = fs::read_to_string(path).map_err(|e| AppError::io(path, e))?; let value: Value = serde_json::from_str(&content).map_err(|e| AppError::json(path, e))?; Ok(value) } fn write_json_value(path: &Path, value: &Value) -> Result<(), AppError> { if let Some(parent) = path.parent() { fs::create_dir_all(parent).map_err(|e| AppError::io(parent, e))?; } let json = serde_json::to_string_pretty(value).map_err(|e| AppError::JsonSerialize { source: e })?; atomic_write(path, json.as_bytes()) } pub fn get_mcp_status() -> Result { let path = user_config_path(); let (exists, count) = if path.exists() { let v = read_json_value(&path)?; let servers = v.get("mcpServers").and_then(|x| x.as_object()); (true, servers.map(|m| m.len()).unwrap_or(0)) } else { (false, 0) }; Ok(McpStatus { user_config_path: path.to_string_lossy().to_string(), user_config_exists: exists, server_count: count, }) } pub fn read_mcp_json() -> Result, AppError> { let path = user_config_path(); if !path.exists() { return Ok(None); } let content = fs::read_to_string(&path).map_err(|e| AppError::io(&path, e))?; Ok(Some(content)) } /// 在 ~/.claude.json 根对象写入 hasCompletedOnboarding=true(用于跳过 Claude Code 初次安装确认) /// 仅增量写入该字段,其他字段保持不变 pub fn set_has_completed_onboarding() -> Result { let path = user_config_path(); let mut root = if path.exists() { read_json_value(&path)? } else { serde_json::json!({}) }; let obj = root .as_object_mut() .ok_or_else(|| AppError::Config("~/.claude.json 根必须是对象".into()))?; let already = obj .get("hasCompletedOnboarding") .and_then(|v| v.as_bool()) .unwrap_or(false); if already { return Ok(false); } obj.insert("hasCompletedOnboarding".into(), Value::Bool(true)); write_json_value(&path, &root)?; Ok(true) } /// 删除 ~/.claude.json 根对象的 hasCompletedOnboarding 字段(恢复 Claude Code 初次安装确认) /// 仅增量删除该字段,其他字段保持不变 pub fn clear_has_completed_onboarding() -> Result { let path = user_config_path(); if !path.exists() { return Ok(false); } let mut root = read_json_value(&path)?; let obj = root .as_object_mut() .ok_or_else(|| AppError::Config("~/.claude.json 根必须是对象".into()))?; let existed = obj.remove("hasCompletedOnboarding").is_some(); if !existed { return Ok(false); } write_json_value(&path, &root)?; Ok(true) } pub fn upsert_mcp_server(id: &str, spec: Value) -> Result { if id.trim().is_empty() { return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into())); } // 基础字段校验(尽量宽松) if !spec.is_object() { return Err(AppError::McpValidation( "MCP 服务器定义必须为 JSON 对象".into(), )); } let t_opt = spec.get("type").and_then(|x| x.as_str()); let is_stdio = t_opt.map(|t| t == "stdio").unwrap_or(true); // 兼容缺省(按 stdio 处理) let is_http = t_opt.map(|t| t == "http").unwrap_or(false); let is_sse = t_opt.map(|t| t == "sse").unwrap_or(false); if !(is_stdio || is_http || is_sse) { return Err(AppError::McpValidation( "MCP 服务器 type 必须是 'stdio'、'http' 或 'sse'(或省略表示 stdio)".into(), )); } // stdio 类型必须有 command if is_stdio { let cmd = spec.get("command").and_then(|x| x.as_str()).unwrap_or(""); if cmd.is_empty() { return Err(AppError::McpValidation( "stdio 类型的 MCP 服务器缺少 command 字段".into(), )); } } // http/sse 类型必须有 url if is_http || is_sse { let url = spec.get("url").and_then(|x| x.as_str()).unwrap_or(""); if url.is_empty() { return Err(AppError::McpValidation(if is_http { "http 类型的 MCP 服务器缺少 url 字段".into() } else { "sse 类型的 MCP 服务器缺少 url 字段".into() })); } } let path = user_config_path(); let mut root = if path.exists() { read_json_value(&path)? } else { serde_json::json!({}) }; // 确保 mcpServers 对象存在 { let obj = root .as_object_mut() .ok_or_else(|| AppError::Config("mcp.json 根必须是对象".into()))?; if !obj.contains_key("mcpServers") { obj.insert("mcpServers".into(), serde_json::json!({})); } } let before = root.clone(); if let Some(servers) = root.get_mut("mcpServers").and_then(|v| v.as_object_mut()) { servers.insert(id.to_string(), spec); } if before == root && path.exists() { return Ok(false); } write_json_value(&path, &root)?; Ok(true) } pub fn delete_mcp_server(id: &str) -> Result { if id.trim().is_empty() { return Err(AppError::InvalidInput("MCP 服务器 ID 不能为空".into())); } let path = user_config_path(); if !path.exists() { return Ok(false); } let mut root = read_json_value(&path)?; let Some(servers) = root.get_mut("mcpServers").and_then(|v| v.as_object_mut()) else { return Ok(false); }; let existed = servers.remove(id).is_some(); if !existed { return Ok(false); } write_json_value(&path, &root)?; Ok(true) } pub fn validate_command_in_path(cmd: &str) -> Result { if cmd.trim().is_empty() { return Ok(false); } // 如果包含路径分隔符,直接判断是否存在可执行文件 if cmd.contains('/') || cmd.contains('\\') { return Ok(Path::new(cmd).exists()); } let path_var = env::var_os("PATH").unwrap_or_default(); let paths = env::split_paths(&path_var); #[cfg(windows)] let exts: Vec = env::var("PATHEXT") .unwrap_or(".COM;.EXE;.BAT;.CMD".into()) .split(';') .map(|s| s.trim().to_uppercase()) .collect(); for p in paths { let candidate = p.join(cmd); if candidate.is_file() { return Ok(true); } #[cfg(windows)] { for ext in &exts { let cand = p.join(format!("{}{}", cmd, ext)); if cand.is_file() { return Ok(true); } } } } Ok(false) } /// 读取 ~/.claude.json 中的 mcpServers 映射 pub fn read_mcp_servers_map() -> Result, AppError> { let path = user_config_path(); if !path.exists() { return Ok(std::collections::HashMap::new()); } let root = read_json_value(&path)?; let servers = root .get("mcpServers") .and_then(|v| v.as_object()) .map(|obj| obj.iter().map(|(k, v)| (k.clone(), v.clone())).collect()) .unwrap_or_default(); Ok(servers) } /// 将给定的启用 MCP 服务器映射写入到用户级 ~/.claude.json 的 mcpServers 字段 /// 仅覆盖 mcpServers,其他字段保持不变 pub fn set_mcp_servers_map( servers: &std::collections::HashMap, ) -> Result<(), AppError> { let path = user_config_path(); let mut root = if path.exists() { read_json_value(&path)? } else { serde_json::json!({}) }; // 构建 mcpServers 对象:移除 UI 辅助字段(enabled/source),仅保留实际 MCP 规范 let mut out: Map = Map::new(); for (id, spec) in servers.iter() { let mut obj = if let Some(map) = spec.as_object() { map.clone() } else { return Err(AppError::McpValidation(format!( "MCP 服务器 '{id}' 不是对象" ))); }; if let Some(server_val) = obj.remove("server") { let server_obj = server_val.as_object().cloned().ok_or_else(|| { AppError::McpValidation(format!("MCP 服务器 '{id}' server 字段不是对象")) })?; obj = server_obj; } obj.remove("enabled"); obj.remove("source"); obj.remove("id"); obj.remove("name"); obj.remove("description"); obj.remove("tags"); obj.remove("homepage"); obj.remove("docs"); // Windows 平台自动包装 npx/npm 等命令为 cmd /c 格式 wrap_command_for_windows(&mut obj); out.insert(id.clone(), Value::Object(obj)); } { let obj = root .as_object_mut() .ok_or_else(|| AppError::Config("~/.claude.json 根必须是对象".into()))?; obj.insert("mcpServers".into(), Value::Object(out)); } write_json_value(&path, &root)?; Ok(()) } #[cfg(test)] mod tests { use super::*; use serde_json::json; /// 测试 Windows 命令包装功能 /// 由于使用条件编译,在非 Windows 平台上测试的是空函数 #[test] fn test_wrap_command_for_windows_npx() { let mut obj = json!({"command": "npx", "args": ["-y", "@upstash/context7-mcp"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); #[cfg(windows)] { assert_eq!(obj["command"], "cmd"); assert_eq!( obj["args"], json!(["/c", "npx", "-y", "@upstash/context7-mcp"]) ); } #[cfg(not(windows))] { // 非 Windows 平台不做任何处理 assert_eq!(obj["command"], "npx"); } } #[test] fn test_wrap_command_for_windows_npm() { let mut obj = json!({"command": "npm", "args": ["run", "start"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); #[cfg(windows)] { assert_eq!(obj["command"], "cmd"); assert_eq!(obj["args"], json!(["/c", "npm", "run", "start"])); } } #[test] fn test_wrap_command_for_windows_already_cmd() { // 已经是 cmd 的不应该重复包装 let mut obj = json!({"command": "cmd", "args": ["/c", "npx", "-y", "foo"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); assert_eq!(obj["command"], "cmd"); // args 应该保持不变,不会变成 ["/c", "cmd", "/c", "npx", ...] assert_eq!(obj["args"], json!(["/c", "npx", "-y", "foo"])); } #[test] fn test_wrap_command_for_windows_http_type_skipped() { // http 类型不应该被处理 let mut obj = json!({"type": "http", "url": "https://example.com/mcp"}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); assert!(!obj.contains_key("command")); assert_eq!(obj["url"], "https://example.com/mcp"); } #[test] fn test_wrap_command_for_windows_other_command_skipped() { // 非目标命令(如 python)不应该被包装 let mut obj = json!({"command": "python", "args": ["server.py"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); // python 不在 WINDOWS_WRAP_COMMANDS 列表中,不应该被包装 assert_eq!(obj["command"], "python"); assert_eq!(obj["args"], json!(["server.py"])); } #[test] fn test_wrap_command_for_windows_no_args() { // 没有 args 的情况 let mut obj = json!({"command": "npx"}).as_object().unwrap().clone(); wrap_command_for_windows(&mut obj); #[cfg(windows)] { assert_eq!(obj["command"], "cmd"); assert_eq!(obj["args"], json!(["/c", "npx"])); } } #[test] fn test_wrap_command_for_windows_with_cmd_suffix() { // 处理 npx.cmd 格式 let mut obj = json!({"command": "npx.cmd", "args": ["-y", "foo"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); #[cfg(windows)] { assert_eq!(obj["command"], "cmd"); assert_eq!(obj["args"], json!(["/c", "npx.cmd", "-y", "foo"])); } } #[test] fn test_wrap_command_for_windows_case_insensitive() { // 大小写不敏感 let mut obj = json!({"command": "NPX", "args": ["-y", "foo"]}) .as_object() .unwrap() .clone(); wrap_command_for_windows(&mut obj); #[cfg(windows)] { assert_eq!(obj["command"], "cmd"); assert_eq!(obj["args"], json!(["/c", "NPX", "-y", "foo"])); } } }