feat(all): add language and runtime fields to MCP server metadata

Added language and runtime fields to MCP server configuration to enable better server identification and display in the debug endpoint. These fields flow from the database through
backend API to satellite processes.

Backend changes:
- Added language and runtime fields to satellite config API response
- Included fields in both active and error server configurations

Satellite changes:
- Updated TypeScript interfaces to include language and runtime fields
- Fixed process spawn to pass language and runtime to running processes
- Added fields to debug endpoint response for visibility
- Updated command polling and config manager to handle new fields

Author: Lasim

services/backend/src/routes/satellites/config.ts

@@ -45,6 +45,8 @@ const CONFIG_RESPONSE_SCHEMA = {
           requires_oauth: { type: 'boolean', description: 'Whether this MCP server requires OAuth authentication' },
           user_id: { type: 'string', description: 'User ID for this specific instance (per-user process)' },
           user_slug: { type: 'string', description: 'User ID used in processId for this specific instance' },
+          language: { type: 'string', description: 'Programming language (e.g., "typescript", "python", "go")' },
+          runtime: { type: 'string', description: 'Runtime environment (e.g., "node", "python", "docker")' },
           secret_metadata: {
             type: 'object',
             properties: {
@@ -166,6 +168,9 @@ interface McpServerConfig {
   requires_oauth?: boolean;
   // Server source (for GitHub detection)
   source?: 'manual' | 'github' | 'official_registry' | null;
+  // Language and runtime from mcpServers table
+  language?: string;
+  runtime?: string;
   settings?: {
     request_logging_enabled?: boolean;
   };
@@ -744,7 +749,10 @@ export default async function satelliteConfigRoute(server: FastifyInstance) {
             // OAuth support for HTTP/SSE MCP servers
             requires_oauth: server.requires_oauth || false,
             // Source (for GitHub detection)
-            source: server.source as 'manual' | 'github' | 'official_registry' | null
+            source: server.source as 'manual' | 'github' | 'official_registry' | null,
+            // Language and runtime from mcpServers table
+            language: server.language || undefined,
+            runtime: server.runtime || undefined
           };
 
           // DEBUG: Log source field being sent to satellite
@@ -1053,7 +1061,9 @@ export default async function satelliteConfigRoute(server: FastifyInstance) {
               transport_type: server.transport_type as 'stdio' | 'http' | 'sse',
               user_id: member.id,
               user_slug: member.id,
-              enabled: false // Disabled due to processing error
+              enabled: false, // Disabled due to processing error
+              language: server.language || undefined,
+              runtime: server.runtime || undefined
             };
           }
         } // Close member loop
@@ -1063,7 +1073,7 @@ export default async function satelliteConfigRoute(server: FastifyInstance) {
         mcp_servers: mcpServerConfigs,
         satellite_config: mergedConfig
       };
-      
+
       request.log.info({
         operation: 'satellite_config_retrieval',
         satelliteId,

services/satellite/src/process/types.ts

@@ -15,6 +15,8 @@ export interface MCPServerConfig {
   args: string[];               // ["-y", "@upstash/context7"]
   env: Record<string, string>;  // Environment variables from three-tier config
   source?: 'manual' | 'github' | 'official_registry' | null; // Server source (for GitHub detection)
+  language?: string;            // Programming language (e.g., "typescript", "python", "go")
+  runtime?: string;             // Runtime environment (e.g., "node", "python", "docker")
   temp_dir?: string;            // Temporary directory path (for GitHub deployments, cleanup on termination)
 }
 

services/satellite/src/routes/status/debug.ts

@@ -18,6 +18,8 @@ interface ServerInfo {
   status: string;
   command: string;
   args: string[];
+  language?: string;
+  runtime?: string;
   pid?: number;
   uptime_ms?: number;
   message_count?: number;
@@ -51,6 +53,8 @@ const serverInfoSchema = {
     status: { type: 'string' },
     command: { type: 'string' },
     args: { type: 'array', items: { type: 'string' } },
+    language: { type: 'string' },
+    runtime: { type: 'string' },
     pid: { type: 'number' },
     uptime_ms: { type: 'number' },
     message_count: { type: 'number' },
@@ -259,6 +263,8 @@ export async function registerDebugRoutes(server: FastifyInstance) {
           error_count: processInfo.errorCount,
           command: processInfo.config.command,
           args: processInfo.config.args,
+          language: processInfo.config.language,
+          runtime: processInfo.config.runtime,
           last_activity: new Date(processInfo.lastActivity).toISOString(),
           restart_count: status?.restart_count || 0,
           ...backendStatusData
@@ -286,6 +292,8 @@ export async function registerDebugRoutes(server: FastifyInstance) {
           status: backendStatusData.backend_status || 'dormant',
           command: config.command,
           args: config.args,
+          language: config.language,
+          runtime: config.runtime,
           message: 'Process terminated due to inactivity, will respawn on next request',
           ...backendStatusData
         });
@@ -319,6 +327,8 @@ export async function registerDebugRoutes(server: FastifyInstance) {
           status: backendStatusData.backend_status || 'configured',
           command: serverConfig.command || serverConfig.url || '',
           args: serverConfig.args || [],
+          language: serverConfig.language,
+          runtime: serverConfig.runtime,
           url: serverConfig.url,
           message: isOnline ? 'Server is online and ready' : (backendStatusData.backend_status ? `Server status: ${backendStatusData.backend_status}` : 'Server configured but not yet started'),
           ...backendStatusData

services/satellite/src/server.ts

@@ -401,7 +401,9 @@ export async function createServer() {
               command: serverConfig.command!,
               args: serverConfig.args!,
               env: serverConfig.env || {},
-              source: serverConfig.source  // GitHub deployment detection
+              source: serverConfig.source,  // GitHub deployment detection
+              language: serverConfig.language,
+              runtime: serverConfig.runtime
             };
 
             // Spawn the process with updated configuration
@@ -470,7 +472,9 @@ export async function createServer() {
               command: serverConfig.command!,
               args: serverConfig.args!,
               env: serverConfig.env || {},
-              source: serverConfig.source  // GitHub deployment detection
+              source: serverConfig.source,  // GitHub deployment detection
+              language: serverConfig.language,
+              runtime: serverConfig.runtime
             };
 
             // Spawn the process

services/satellite/src/services/command-polling-service.ts

@@ -88,6 +88,12 @@ export interface McpServerConfig {
   /** Server source - for GitHub deployment detection */
   source?: 'manual' | 'github' | 'official_registry' | null;
 
+  /** Programming language (e.g., "typescript", "python", "go") */
+  language?: string;
+
+  /** Runtime environment (e.g., "node", "python", "docker") */
+  runtime?: string;
+
   /** GitHub repository information (parsed from github: URLs) */
   github_owner?: string;
   github_repo?: string;

services/satellite/src/types/mcp-server.ts

@@ -64,6 +64,12 @@ export interface McpServerConfig {
   /** User ID that owns this instance (per-user process) */
   user_id?: string;
 
+  /** Programming language (e.g., "typescript", "python", "go") */
+  language?: string;
+
+  /** Runtime environment (e.g., "node", "python", "docker") */
+  runtime?: string;
+
   /** Metadata about which fields contain secrets (for secure logging) */
   secret_metadata?: {
     /** Names of query parameters that are secrets */

services/satellite/src/utils/runtime-validator.ts

@@ -8,6 +8,11 @@ import { spawnSync } from 'child_process';
  * but required runtimes are missing on the system.
  */
 
+interface Logger {
+  info: (obj: Record<string, unknown>, msg: string) => void;
+  fatal: (obj: Record<string, unknown>, msg: string) => void;
+}
+
 interface RuntimeCheck {
   name: string;           // Display name (e.g., "Node.js")
   commands: string[];     // Commands to check (e.g., ["node", "npx"])
@@ -207,7 +212,7 @@ function buildWarningMessage(result: RuntimeCheckResult): string {
  * @param logger - Logger instance (must have info() and fatal() methods)
  * @throws Never - Calls process.exit(1) on fatal errors
  */
-export function validateSystemRuntimes(logger: { info: (msg: string) => void; fatal: (msg: string) => void }): void {
+export function validateSystemRuntimes(logger: Logger): void {
   // Check if skip flag is set
   const skipChecks = process.env.DEPLOYSTACK_SKIP_RUNTIME_CHECKS === 'true';