Nhn Server MCP

🚀 NHN Server MCP

The MCP (Model Context Protocol) server enables access to servers via an SSH Gateway and execution of commands.

✨ Features

• Server access through an SSH Gateway.
• Support for Kerberos authentication (kinit).
• Command execution confirmation via macOS native dialogs.
• Automatic approval of the same command with the "Always Allow" option.
• Server information retrieval (AI can check log paths, etc.).
• Dynamic reloading of configurations.

📦 Installation

npm install
npm run build

📚 Configuration

1. Create config.json

{
  "gatewayConnection": "user@gateway.example.com:22",
  "gatewayPassword": "your-password",
  "kinitPassword": "your-kerberos-password",
  "allowedHosts": ["server1", "server2"],
  "confirmDialog": true,
  "serverInfo": {
    "Required user information for the server": "The user is sent along when executing commands.",
    "The rest": "Can be customized as desired.",
    "ex - logPaths": {
      "app": "/var/log/app.log",
      "nginx": "/var/log/nginx/access.log"
    }
  }
}

2. Client Configuration

Claude Code (CLI)

Register using CLI commands:

# Project-specific (used only in the current project)
claude mcp add --scope project nhn-server -e CONFIG_FILE=/path/to/config.json -e DEBUG=false -- node /path/to/nhn-server-mcp/dist/index.js

# Global (used in all projects)
claude mcp add --scope user nhn-server -e CONFIG_FILE=/path/to/config.json -e DEBUG=false -- node /path/to/nhn-server-mcp/dist/index.js

Alternatively, you can edit the configuration file directly.

Project-specific — Create .mcp.json in the project root:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

Global — Add to ~/.claude.json:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

.mcp.json — Used only in the current project. Can be shared with team members by committing to git (Note that the config.json path may vary for each user).

~/.claude.json — Used in all projects. For personal environment configuration.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

📋 Configuration Options

Environment Variables

💻 Usage Examples

exec

Execute commands on the server.

{
  "host": "server-hostname",
  "user": "irteam",
  "command": "tail -100 /var/log/app.log"
}

If confirmDialog is enabled, a macOS native dialog will be displayed:

• Cancel: Do not execute the command.
• OK: Execute the command this time only.
• Always Allow: Execute the command and automatically approve the same command in the future (reset when the session ends).

get_config

Retrieve server configuration information (allowed hosts, server information).

reload_config

Reload the configuration file.

disconnect_server

Terminate the Gateway connection.

connection_status

Check the current connection status.

🔒 Security

• Do not commit config.json to git as it contains sensitive information (passwords).
• Obtain user confirmation before command execution using confirmDialog.
• Limit accessible servers using allowedHosts.
• Automatically terminate the connection after 5 minutes of inactivity.
• Automatically clean up the session even in case of exceptions.

📄 License

MIT