check-mcp-server-process

Verify the process status of an MCP server to diagnose and resolve operational issues. Input the server name to analyze logs, validate configurations, and ensure seamless functionality.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`serverName`	Yes	Name of the MCP server to check

Implementation Reference

src/index.ts:559-644 (handler)

Full implementation of the 'check-mcp-server-process' tool handler. Reads Claude Desktop config, parses JSON to find server command, then uses platform-specific commands (tasklist on Windows, ps/grep on Unix) to check if the process is running and returns details or status.

server.tool(
  "check-mcp-server-process",
  {
    serverName: z.string().describe("Name of the MCP server to check")
  },
  async ({ serverName }) => {
    try {
      // Read configuration to get the command for this server
      try {
        await fs.access(configPath);
      } catch (error) {
        return {
          content: [{ type: "text", text: `Configuration file not found at ${configPath}.` }]
        };
      }

      const configContent = await fs.readFile(configPath, 'utf-8');
      let configObject;
      
      try {
        configObject = JSON.parse(configContent);
      } catch (error) {
        return {
          isError: true,
          content: [{ type: "text", text: `Invalid JSON in configuration file: ${error.message}` }]
        };
      }
      
      if (!configObject.mcpServers || !configObject.mcpServers[serverName]) {
        return {
          content: [{ type: "text", text: `Server '${serverName}' not found in configuration.` }]
        };
      }
      
      const serverConfig = configObject.mcpServers[serverName];
      const command = serverConfig.command;
      
      if (!command) {
        return {
          content: [{ type: "text", text: `Server '${serverName}' has no command specified in configuration.` }]
        };
      }
      
      // Check if process is running (platform specific)
      const platform = os.platform();
      let processCheckCommand;
      
      if (platform === "win32") {
        processCheckCommand = `tasklist /FI "IMAGENAME eq ${command}*"`;
      } else {
        processCheckCommand = `ps aux | grep "${command}" | grep -v grep`;
      }
      
      try {
        const { stdout } = await execAsync(processCheckCommand);
        
        if (stdout.trim()) {
          // Process is likely running
          return {
            content: [{ 
              type: "text", 
              text: `Process for server '${serverName}' appears to be running.\n\nProcess details:\n\`\`\`\n${stdout}\n\`\`\`` 
            }]
          };
        } else {
          return {
            content: [{ type: "text", text: `No running process found for server '${serverName}'.` }]
          };
        }
      } catch (error) {
        // Process not found or error checking
        return {
          content: [{ 
            type: "text", 
            text: `No running process found for server '${serverName}', or error checking process: ${error.message}` 
          }]
        };
      }
    } catch (error) {
      return {
        isError: true,
        content: [{ type: "text", text: `Error checking server process: ${error.message}` }]
      };
    }
  }
);

src/index.ts:561-563 (schema)
Input schema for the tool using Zod: requires 'serverName' string parameter.
```
{
  serverName: z.string().describe("Name of the MCP server to check")
},
```

src/index.ts:560-644 (registration)

Registers the tool on the MCP server instance with name, schema, and handler.

  "check-mcp-server-process",
  {
    serverName: z.string().describe("Name of the MCP server to check")
  },
  async ({ serverName }) => {
    try {
      // Read configuration to get the command for this server
      try {
        await fs.access(configPath);
      } catch (error) {
        return {
          content: [{ type: "text", text: `Configuration file not found at ${configPath}.` }]
        };
      }

      const configContent = await fs.readFile(configPath, 'utf-8');
      let configObject;
      
      try {
        configObject = JSON.parse(configContent);
      } catch (error) {
        return {
          isError: true,
          content: [{ type: "text", text: `Invalid JSON in configuration file: ${error.message}` }]
        };
      }
      
      if (!configObject.mcpServers || !configObject.mcpServers[serverName]) {
        return {
          content: [{ type: "text", text: `Server '${serverName}' not found in configuration.` }]
        };
      }
      
      const serverConfig = configObject.mcpServers[serverName];
      const command = serverConfig.command;
      
      if (!command) {
        return {
          content: [{ type: "text", text: `Server '${serverName}' has no command specified in configuration.` }]
        };
      }
      
      // Check if process is running (platform specific)
      const platform = os.platform();
      let processCheckCommand;
      
      if (platform === "win32") {
        processCheckCommand = `tasklist /FI "IMAGENAME eq ${command}*"`;
      } else {
        processCheckCommand = `ps aux | grep "${command}" | grep -v grep`;
      }
      
      try {
        const { stdout } = await execAsync(processCheckCommand);
        
        if (stdout.trim()) {
          // Process is likely running
          return {
            content: [{ 
              type: "text", 
              text: `Process for server '${serverName}' appears to be running.\n\nProcess details:\n\`\`\`\n${stdout}\n\`\`\`` 
            }]
          };
        } else {
          return {
            content: [{ type: "text", text: `No running process found for server '${serverName}'.` }]
          };
        }
      } catch (error) {
        // Process not found or error checking
        return {
          content: [{ 
            type: "text", 
            text: `No running process found for server '${serverName}', or error checking process: ${error.message}` 
          }]
        };
      }
    } catch (error) {
      return {
        isError: true,
        content: [{ type: "text", text: `Error checking server process: ${error.message}` }]
      };
    }
  }
);

MCP Troubleshooter