MCP 구축

개요

본 문서는 2025년 11월 20일 기준으로 작성되었습니다.
Claude Desktop 및 LM Studio에서 MCP 환경을 구성하는 일반적인 과정을 설명합니다.
LM Studio는 0.3.32 버전을 사용하였습니다.

전체 과정

Claude Desktop에서 사용자가 리눅스 서버 내 작업을 요청합니다.
LLM이 사용자의 명령을 이해하고 MCP Server가 제공하는 도구를 선택합니다.
MCP 서버가 작업을 수행하고 LLM에 결과를 반환합니다.
LLM은 결과를 바탕으로 사용자에게 답변합니다.

환경 구성

MCP 서버를 설치합니다.
- GitHub이나 Smithery에서 SSH 명령 기능을 제공하는 다양한 MCP 서버를 찾을 수 있습니다.
- 여기서는 https://github.com/AiondaDotCom/mcp-ssh를 사용했습니다. 이 MCP 서버는 윈도우 C:\Users\User\.ssh\config을 활용해서 다수의 호스트를 관리할 수 있습니다.
- 자세한 설치 방법은 https://github.com/AiondaDotCom/mcp-ssh/releases/tag/v1.0.3를 참고하세요.
- 설치가 정상적으로 완료되면 Claude Desktop에 mcp-ssh 도구가 활성화 된 것을 확인할 수 있습니다.

SSH 공개키 인증을 설정합니다.
- MCP 서버가 리눅스 서버에 접근할 때 패스워드 입력 대신 공개키로 접근할 수 있도록 설정합니다.

# 윈도우에 개인키&공개키 생성

ssh-keygen -t ed25519 -f $env:USERPROFILE\.ssh\my_id_edd25519 -C "your_email_or_memo"

# 공개키 확인

type $env:USERPROFILE\.ssh\my_id_ed25519.pub

# 서버에 공개키 복사

ssh user@server-ip-or-hostname

vi ~/.ssh/authorized_keys

# 이후 서버에 다시 접속 시 패스워드 입력없이 접근 가능

# 키에 Passphrase를 설정하였을 경우 윈도우 SSH-Agent 서비스 활성화

Get-Service ssh-agent

Set-Service -Name ssh-agent -StartupType Automatic

Start-Service ssh-agent

ssh-add $env:USERPROFILE\.ssh\my_id_edd25519

# 키 확인 및 제거

ssh-add -l # 등록된 키 목록

ssh-add -d <key> # 특정 키 삭제

ssh-add -D # 모든 키 삭제

C:\Users\User\.ssh\config에 MCP 서버가 접근할 수 있는 서버들의 접속 정보를 설정합니다.

Host server-ip-or-hostname-1

HostName server-ip-1

User user

IdentityFile C:\Users\User\.ssh\my_id_ed25519

StrictHostKeyChecking no

UserKnownHostsFile NUL

ServerAliveInterval 60

Host server-ip-or-hostname-2

HostName server-ip-2

User user

IdentityFile C:\Users\User\.ssh\my_id_ed25519

StrictHostKeyChecking no

UserKnownHostsFile NUL

ServerAliveInterval 60

명령 실행

Claude Desktop에서 사용자가 자연어로 명령하면 LLM이 MCP 서버를 사용하여 리눅스 명령어를 실행하고 그 결과를 반환합니다.

서버의 설정 상태나 취약점을 분석할 수 있습니다.

엘라스틱의 Diagnostics 파일을 생성하고 분석할 수 있습니다.

Private LLM 활용

LM Studio에서 MCP를 구성할 수 있습니다.
mcp.json에 아래의 코드를 추가합니다.

{

"mcpServers": {

"mcp-ssh": {

"command": "node",

"args": [

"C:\\Users\\user\\AppData\\Roaming\\Claude\\Claude Extensions\\local.dxt.aionda.com.mcp-ssh\\server-simple.mjs"

"env": {

"MCP_SILENT": "true",

"PATH": "C:\\Windows\\System32\\OpenSSH;C:\\Program Files\\nodejs;%PATH%"

}

mcp-ssh가 활성화 된 것을 확인할 수 있습니다.

openai/gpt-oss-20b 모델이 MCP 서버를 사용하여 사용자의 자연어 명령을 수행합니다.

덧붙임

시스템 관리자의 반복적인 업무나 Ad-hoc 분석에 유용합니다.
SSH로 위험한 작업이 실행될 수 있으므로 LLM이 진행하려는 실제 명령을 확인하고 허용하는 게 좋습니다. 가드레일을 구성하는 것도 방법입니다.

Page updated

Report abuse