chore: import upstream snapshot with attribution

2026-07-13 12:49:17 +08:00
commit 7243d5823b
2201 changed files with 257291 additions and 0 deletions
@@ -0,0 +1,55 @@
+using System.Collections.Generic;
+
+namespace MCPForUnity.Editor.Services.Server
+{
+    /// <summary>
+    /// Interface for platform-specific process inspection operations.
+    /// Provides methods to detect MCP server processes, query process command lines,
+    /// and find processes listening on specific ports.
+    /// </summary>
+    public interface IProcessDetector
+    {
+        /// <summary>
+        /// Determines if a process looks like an MCP server process based on its command line.
+        /// Checks for indicators like uvx, python, mcp-for-unity, uvicorn, etc.
+        /// </summary>
+        /// <param name="pid">The process ID to check</param>
+        /// <returns>True if the process appears to be an MCP server</returns>
+        bool LooksLikeMcpServerProcess(int pid);
+
+        /// <summary>
+        /// Attempts to get the command line arguments for a Unix process.
+        /// </summary>
+        /// <param name="pid">The process ID</param>
+        /// <param name="argsLower">Output: normalized (lowercase, whitespace removed) command line args</param>
+        /// <returns>True if the command line was retrieved successfully</returns>
+        bool TryGetProcessCommandLine(int pid, out string argsLower);
+
+        /// <summary>
+        /// Gets the process IDs of all processes listening on a specific TCP port.
+        /// </summary>
+        /// <param name="port">The port number to check</param>
+        /// <returns>List of process IDs listening on the port</returns>
+        List<int> GetListeningProcessIdsForPort(int port);
+
+        /// <summary>
+        /// Gets the current Unity Editor process ID safely.
+        /// </summary>
+        /// <returns>The current process ID, or -1 if it cannot be determined</returns>
+        int GetCurrentProcessId();
+
+        /// <summary>
+        /// Checks if a process exists on Unix systems.
+        /// </summary>
+        /// <param name="pid">The process ID to check</param>
+        /// <returns>True if the process exists</returns>
+        bool ProcessExists(int pid);
+
+        /// <summary>
+        /// Normalizes a string for matching by removing whitespace and converting to lowercase.
+        /// </summary>
+        /// <param name="input">The input string</param>
+        /// <returns>Normalized string for matching</returns>
+        string NormalizeForMatch(string input);
+    }
+}