Skip to main content
Glama
dhks77

NHN Server MCP

by dhks77
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

설정 옵션

키

설명

기본값

gatewayConnection

Gateway SSH 연결 (user@host:port)

-

gatewayPassword

Gateway SSH 비밀번호

-

kinitPassword

Kerberos 인증 비밀번호

-

allowedHosts

접속 허용 호스트 목록

[] (모두 허용)

confirmDialog

명령 실행 전 확인 다이얼로그 표시

true

serverInfo

AI에게 노출할 서버 정보

{}

환경변수

변수

설명

CONFIG_FILE

config.json 파일 경로

DEBUG

디버그 로그 활성화 (true/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

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dhks77/nhn-server-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server