MCP SSH Agent

Instructions

Implementation Reference

• src/ssh-client.ts:17-19 (handler)

  The main handler function for the 'listKnownHosts' tool. It calls the config parser's getAllKnownHosts method to retrieve the list of known SSH hosts.

  async listKnownHosts(): Promise<SSHHostInfo[]> {
    return await this.configParser.getAllKnownHosts();
  }

• src/types.ts:2-9 (schema)

  Interface defining the structure of SSHHostInfo, which is the return type of the listKnownHosts tool.

  export interface SSHHostInfo {
    hostname: string;
    alias?: string;
    user?: string;
    port?: number;
    identityFile?: string;
    [key: string]: any; // For other configuration options
  }

• src/ssh-config-parser.ts:100-116 (helper)

  Helper method in SSHConfigParser that implements the core logic: parses ~/.ssh/config for hosts and ~/.ssh/known_hosts for additional hostnames, combining them into SSHHostInfo array.

  async getAllKnownHosts(): Promise<SSHHostInfo[]> {
    const configHosts = await this.parseConfig();
    const knownHostnames = await this.parseKnownHosts();
  
    // Add hosts from known_hosts that aren't in the config
    for (const hostname of knownHostnames) {
      if (!configHosts.some(host => 
          host.hostname === hostname || 
          host.alias === hostname)) {
        configHosts.push({
          hostname: hostname
        });
      }
    }
  
    return configHosts;
  }