NHN Server MCP

SSHゲートウェイを介してサーバーに接続し、コマンドを実行するためのMCP (Model Context Protocol) サーバーです。

機能

SSHゲートウェイを介したサーバー接続
Kerberos認証 (kinit) サポート
macOSネイティブダイアログによるコマンド実行確認
「常に許可」オプションによる同一コマンドの自動承認
サーバー情報の照会 (AIがログパスなどを確認可能)
ゲートウェイ経由のSCPファイルアップロード/ダウンロード
リモートコマンドのタイムアウトによるプロセスハングの防止
設定の動的リロード

インストール

npm install
npm run build

設定

1. config.jsonの作成

{
  "gatewayConnection": "user@gateway.example.com:22",
  "gatewayPassword": "your-password",
  "kinitPassword": "your-kerberos-password",
  "allowedHosts": ["server1", "server2"],
  "confirmDialog": true,
  "serverInfo": {
    "서버에 대한 user 정보 필수": "exec 할때 user 를 같이 보냅니다.",
    "나머지는": "원하는 내용으로",
    "ex - logPaths": {
      "app": "/var/log/app.log",
      "nginx": "/var/log/nginx/access.log"
    }
  }
}

2. クライアント設定

Claude Code (CLI)

CLIコマンドで登録:

# 프로젝트 단위 (해당 프로젝트에서만 사용)
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

# 글로벌 (모든 프로젝트에서 사용)
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

または、設定ファイルを直接編集することもできます。

プロジェクト単位 — プロジェクトルートに .mcp.json を作成:

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

グローバル — ~/.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 — そのプロジェクトでのみ使用。gitにコミットすればチームメンバーと共有可能 (ただし、config.json のパスが各々異なる可能性があるため注意)
~/.claude.json — すべてのプロジェクトで使用。個人環境設定用

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"
      }
    }
  }
}

設定オプション

キー	説明	デフォルト値
`gatewayConnection`	ゲートウェイSSH接続 (user@host:port)	-
`gatewayPassword`	ゲートウェイSSHパスワード	-
`kinitPassword`	Kerberos認証パスワード	-
`allowedHosts`	接続許可ホストリスト	[] (すべて許可)
`confirmDialog`	コマンド実行前の確認ダイアログ表示	true
`serverInfo`	AIに公開するサーバー情報	{}
`commandTimeoutSec`	リモートコマンドのタイムアウト (秒)。GNU timeoutでラップ	300

環境変数

変数	説明
`CONFIG_FILE`	config.jsonファイルのパス
`DEBUG`	デバッグログの有効化 (`true`/`false`)

MCPツール

exec

サーバーでコマンドを実行します。

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

confirmDialog が有効な場合、macOSネイティブダイアログが表示されます:

キャンセル: コマンドを実行しない
確認: 今回のみ実行
常に許可: 実行 + 以降同じコマンドは確認なしで実行 (セッション終了時に初期化)

get_config

サーバー設定情報を照会します。(許可ホスト、サーバー情報)

reload_config

設定ファイルを再読み込みします。

disconnect_server

ゲートウェイ接続を切断します。

connection_status

現在の接続状態を確認します。

scp_upload

ファイル内容をサーバーにアップロードします。(ゲートウェイ経由のSCP)

{
  "host": "server-hostname",
  "user": "appuser",
  "remotePath": "/path/to/remote/file.txt",
  "content": "파일 내용"
}

scp_download

サーバーからファイルをダウンロードします。(ゲートウェイ経由のSCP)

{
  "host": "server-hostname",
  "user": "appuser",
  "remotePath": "/path/to/remote/file.txt",
  "localPath": "/path/to/local/file.txt"
}

localPath 指定時: ローカルファイルとして保存
localPath 未指定時: ファイル内容のみを返却

セキュリティ

config.json には機密情報(パスワード)が含まれるため、gitにコミットしないでください
confirmDialog により、コマンド実行前にユーザーの確認を求めます
allowedHosts により、接続可能なサーバーを制限します
5分間非アクティブな場合、自動的に接続を切断します
例外発生時にもセッションを自動的にクリーンアップします

ライセンス

MIT

NHN Server MCP

NHN Server MCP

機能

インストール

設定

1. config.jsonの作成

2. クライアント設定

Claude Code (CLI)

Claude Desktop

設定オプション

環境変数

MCPツール

exec

get_config

reload_config

disconnect_server

connection_status

scp_upload

scp_download

セキュリティ

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API