The NHN Server MCP is a Model Context Protocol server that provides secure SSH gateway access to remote servers with Kerberos authentication and command execution capabilities.
Core Capabilities:
Execute Remote Commands (
exec) - Run commands on specified servers through an SSH gateway with required host, user, and command parametersView Server Configuration (
get_config) - Query current settings including allowed hosts, whitelisted commands, and server information like log pathsReload Configuration (
reload_config) - Dynamically reload the configuration file without restartingCheck Connection Status (
connection_status) - Monitor the current SSH gateway connection stateDisconnect from Gateway (
disconnect_server) - Manually terminate the SSH gateway connection
Security Features:
Kerberos (kinit) authentication support
Host allowlist to restrict server access
Command whitelisting
macOS native confirmation dialogs with "always allow" option for trusted commands (session-scoped)
Automatic session cleanup after 5 minutes of inactivity
Prevents sensitive config file commits
Use Cases:
Access servers behind SSH gateways from AI assistants
Retrieve and analyze server logs
Execute maintenance commands with approval workflows
Enable AI to understand server topology and log locations
Configure for project-specific or global use across Claude CLI, Desktop, and other MCP clients
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NHN Server MCPshow me the last 50 lines of the app log on server1"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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"
}
}
}
}설정 옵션
키 | 설명 | 기본값 |
| Gateway SSH 연결 (user@host:port) | - |
| Gateway SSH 비밀번호 | - |
| Kerberos 인증 비밀번호 | - |
| 접속 허용 호스트 목록 | [] (모두 허용) |
| 명령 실행 전 확인 다이얼로그 표시 | true |
| AI에게 노출할 서버 정보 | {} |
환경변수
변수 | 설명 |
| config.json 파일 경로 |
| 디버그 로그 활성화 ( |
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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.