Nhn Server MCP

🚀 NHN Server MCP

SSH Gatewayを介してサーバーに接続し、コマンドを実行するMCP (Model Context Protocol) サーバーです。

✨ 主な機能

• SSH Gatewayを通じたサーバー接続
• Kerberos認証 (kinit) のサポート
• macOSネイティブダイアログでコマンド実行を確認
• "常に許可" オプションで同じコマンドを自動承認
• サーバー情報の照会 (AIがログパスなどを確認可能)
• 設定の動的再読み込み

📦 インストール

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

設定オプション

環境変数

💻 使用例

exec

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

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

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

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

get_config

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

reload_config

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

disconnect_server

Gateway接続を切断します。

connection_status

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

🔧 技術詳細

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

📄 ライセンス

MIT