NHN Server MCP

SSH Gateway를 통해 서버에 접속하고 명령어를 실행하는 MCP (Model Context Protocol) 서버입니다.

기능

SSH Gateway를 통한 서버 접속
Kerberos 인증 (kinit) 지원
명령어 화이트리스트
위험 패턴 차단 (설정 가능)
서버 정보 조회 (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"], "blockedPatterns": [">", "`", "$(", ";", "&&", "||"], "allowedCommands": [ "tail", "head", "cat", "grep", "ls", "ps", "whoami" ], "serverInfo": { "서버에 대한 user 정보 필수": "exec 할때 user 를 같이 보냅니다.", "나머지는": "원하는 내용으로", "ex - logPaths": { "app": "/var/log/app.log", "nginx": "/var/log/nginx/access.log" } } }

2. 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`	접속 허용 호스트 목록	[] (모두 허용)
`allowedCommands`	실행 허용 명령어 목록	기본 명령어 목록
`blockedPatterns`	차단할 패턴 목록	`[">", "\`", "$(", ";", "&&", "\|\|"]`
`serverInfo`	AI에게 노출할 서버 정보	{}

환경변수

변수	설명
`CONFIG_FILE`	config.json 파일 경로
`DEBUG`	디버그 로그 활성화 (`true`/`false`)

MCP 도구

exec

서버에서 명령어를 실행합니다.

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

get_config

서버 설정 정보를 조회합니다. (허용 호스트, 명령어, 서버 정보)

reload_config

설정 파일을 다시 로드합니다.

disconnect_server

Gateway 연결을 종료합니다.

connection_status

현재 연결 상태를 확인합니다.

보안

config.json에 민감한 정보(비밀번호)가 포함되므로 git에 커밋하지 마세요
blockedPatterns로 위험한 명령어 패턴을 차단합니다
allowedHosts로 접속 가능한 서버를 제한합니다
allowedCommands로 실행 가능한 명령어를 제한합니다
5분 비활성 시 자동 연결 종료

라이선스

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

NHN Server MCP

NHN Server MCP

기능

설치

설정

1. config.json 생성

2. Claude Desktop 설정

설정 옵션

환경변수

MCP 도구

exec

get_config

reload_config

disconnect_server

connection_status

보안

라이선스

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API