Nhn Server MCP

🚀 NHN Server MCP

NHN Server MCP 是一個 MCP（Model Context Protocol）服務器，可通過 SSH Gateway 連接到服務器並執行命令。

🚀 快速開始

NHN Server MCP 允許你通過 SSH Gateway 連接服務器並執行命令。下面將為你介紹其主要特性、安裝步驟、配置方法等內容。

✨ 主要特性

• 通過 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"
      }
    }
  }
}

配置選項

環境變量

MCP 工具

exec

在服務器上執行命令：

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

如果 confirmDialog 啟用，將顯示 macOS 原生對話框：

• 取消：不執行命令
• 確認：僅執行本次命令
• 始終允許：執行命令並在後續自動批准相同命令（會話結束時重置）

get_config

查詢服務器配置信息（允許的主機、服務器信息）。

reload_config

重新加載配置文件。

disconnect_server

斷開 Gateway 連接。

connection_status

檢查當前連接狀態。

🔧 技術細節

安全措施

• 由於 config.json 包含敏感信息（密碼），請勿將其提交到 git 倉庫。
• 使用 confirmDialog 確保在執行命令前獲得用戶確認。
• 使用 allowedHosts 限制可連接的服務器。
• 系統在 5 分鐘無操作後自動斷開連接。
• 發生異常時自動清理會話。

📄 許可證

本項目採用 MIT 許可證。