tufantunc/SSH-MCP 활용: Termux 원격 접속으로 스마트폰을 개발 서버처럼!

Q: Termux에서 SSH 접속이 잘 안 돼요. 뭐가 문제일까요?

👉 Termux에서 sshd 명령어가 실행 중인지, 비밀번호는 올바르게 설정했는지, 스마트폰과 PC가 같은 네트워크에 연결되어 있는지, 그리고 Termux가 백그라운드에서 강제로 종료되지 않도록 배터리 최적화 설정을 확인해 보세요.

Q: tufantunc/SSH-MCP는 어디서 다운로드할 수 있나요?

👉 tufantunc/SSH-MCP는 GitHub에서 찾을 수 있는 오픈소스 프로젝트입니다. GitHub에서 검색하여 소스 코드 및 관련 정보를 확인하실 수 있습니다.

Q: Termux에서 코딩할 때 스마트폰 키보드가 너무 불편해요.

👉 PC로 원격 접속하여 물리 키보드를 사용하거나, 스마트폰에 블루투스 키보드를 연결하여 사용하시는 것을 강력히 추천합니다.

Termux

tufantunc/SSH-MCP 활용: Termux 원격 접속으로 스마트폰을 개발 서버처럼!

모과나무99 2025. 6. 15. 09:27

Claude Desktop, tufantunc/SSH-MCP로 Termux 코딩 환경 만들기! 안드로이드 스마트폰을 나만의 강력한 개발 워크스테이션으로 변신시키는 방법을 알려드릴게요. 원격 접속과 효율적인 코딩 환경 구축으로 언제 어디서든 코딩에 몰입해 보세요!

솔직히 말해서, 저도 예전에 스마트폰으로 코딩하는 건 상상도 못 했어요. 작은 화면에 불편한 터치 키보드... 생각만 해도 답답했죠. 그런데 말이죠, Termux와 SSH를 활용하면 이야기가 완전히 달라집니다! 특히 Claude Desktop 같은 편리한 도구를 만나면 금상첨화죠. 이제 더 이상 비싼 노트북이나 복잡한 서버 설정 없이도, 제 손안의 작은 컴퓨터로 멋진 코드들을 만들어낼 수 있게 되었어요. 같이 한번 알아볼까요?

Termux, 너는 대체 뭐니?

Termux는 안드로이드 기기에서 리눅스 명령줄 환경을 에뮬레이트해주는 앱이에요. 그냥 터미널 앱이라고 생각할 수 있지만, 사실 그 이상이랍니다! APT 패키지 관리자를 통해 수많은 리눅스 도구와 언어를 설치할 수 있어요. Python, Node.js, Git, Vim 등 웬만한 개발 환경은 다 구축할 수 있죠. 저도 처음엔 반신반의했지만, 직접 써보니 완전 신세계더라고요!

알아두세요!
Termux는 Google Play 스토어보다는 F-Droid에서 설치하는 것을 권장해요. Google Play 버전은 업데이트가 지연될 수 있거든요! 최신 기능을 사용하려면 F-Droid를 이용하는 게 훨씬 좋습니다.

Termux에 SSH 서버 깔기 (ft. OpenSSH)

자, 이제 Termux를 외부에서 접속할 수 있게 만들어볼 거예요. 바로 SSH 서버를 설치하는 거죠! 이게 되면 스마트폰을 주머니에 넣고 있어도, 제 컴퓨터로 원격 접속해서 마치 서버에 접속하듯이 코딩할 수 있게 됩니다. 진짜 멋지지 않나요?

먼저 Termux 앱을 열고 다음 명령어를 입력해서 필요한 패키지를 업데이트하고 OpenSSH를 설치합니다.
```
pkg update && pkg upgrade
```
```
pkg install openssh
```
설치가 완료되면, SSH 비밀번호를 설정해야 해요. sshd 명령어로 SSH 서버를 실행하고, passwd 명령어로 비밀번호를 설정합니다.
```
sshd
```
```
passwd
```
(비밀번호는 최소 8자 이상으로 설정하는 게 좋아요. 보안은 언제나 중요하니까요!)
Termux SSH 서버의 기본 포트는 8022번이에요. 이 포트 번호를 잘 기억해두세요!

주의하세요!
Termux 앱이 백그라운드에서 강제로 종료되거나, 배터리 최적화 설정 때문에 SSH 서버가 꺼질 수 있어요. Termux 설정에서 '배터리 최적화 예외'로 설정하거나, 'wakelock'을 사용하여 화면이 꺼져도 백그라운드에서 계속 실행되도록 하는 것이 좋습니다. (termux-wake-lock 명령어 사용)

Claude Desktop을 이용한 원격 코딩 환경 구축

이제 여러분의 컴퓨터에서 Termux에 접속할 차례입니다. 여러 SSH 클라이언트가 있지만, 개인적으로 Claude Desktop 의 mcp-server로 tufantunc/SSH-MCP 같은 프로그램들을 추천해요. 특히 tufantunc/SSH-MCP는 GitHub에서 찾을 수 있는 오픈소스 프로젝트로, SSH 접속 관리에 유용하게 쓰일 수 있습니다.

먼저 Termux가 실행 중인 스마트폰의 IP 주소를 알아야겠죠? Termux에서 다음 명령어를 입력합니다.

ifconfig

출력되는 정보 중에서 `inet` 다음에 나오는 IP 주소를 메모해두세요. (예: 192.168.0.XX)

이제 Claude Desktop의 tufantunc/SSH-MCP 셋팅 하기.

설치와 셋팅방법은 제 블로그에 있습니다. MCP 프로토콜 이해하기: Claude Desktop과 VS Code로 SSH를 자동화하는 방법

MCP 프로토콜 이해하기: Claude Desktop과 VS Code로 SSH를 자동화하는 방법

Claude & VS Code와 VPS를 안전하게 연결하는 방법: SSH-MCP 마스터하기! AI 도구들이 SSH-MCP를 통해 원격 서버에 안전하고 효율적으로 접속하는 비결을 알려드립니다. Node.js 기반의 `tufantunc/SSH-MCP` 프로젝

webstory99.tistory.com

PC 설정 (SSH 클라이언트 준비 및 비밀번호 없는 접속 설정)

Claude가 자동화를 수행하려면 매번 비밀번호를 묻지 않도록 'SSH 키 기반 인증'을 설정하는 것이 핵심입니다.

PC에서 SSH 키 생성

PC의 터미널(PowerShell, Terminal 등)에서 아래 명령어를 실행하여 공개키/비밀키 쌍을 생성합니다.

ssh-keygen -t rsa -b 4096

파일 저장 위치나 암호를 묻는 메시지가 나오면 그냥 Enter 키를 눌러 기본값으로 진행합니다. (~/.ssh/ 폴더에 id_rsa(비밀키), id_rsa.pub(공개키) 파일이 생성됩니다.)

PC의 공개키를 Termux로 복사

아래 명령어를 PC 터미널에서 실행하여 PC의 공개키를 스마트폰의 Termux에 등록합니다.

ssh-copy-id -p 8022 [termux_username]@[phone_ip_address]

예시: ssh-copy-id -p 8022 u0_a291@192.168.1.10

비밀번호 없는 접속 테스트

이제 PC에서 아래 명령어를 실행하면 비밀번호 없이 바로 Termux 쉘에 접속되어야 합니다.

ssh -p 8022 [termux_username]@[phone_ip_address]

Claude Desktop mcp-server 셋팅예시

"ssh-mcp": {
            "command": "node",
            "args": [
                "C:\\Users\\test\\my_app\\ssh-mcp\\build\\index.js",
                "-y",
                "--",
                "--host=192.168.0.25",
                "--port=8022",
                "--user=u0_a312",
                "--password=1234",
                "--key=C:\\Users\\test\\.ssh\\id_rsa"
            ]
        },

내컴퓨터 claude desktop 에서 명령내리는 이미지 캪쳐

호스트 (Host): 스마트폰의 IP 주소
포트 (Port): 8022
사용자 이름 (Username): Termux의 기본 사용자 이름은 localhost 또는 u0_aXXX (숫자는 기기마다 다름) 일 수 있지만, 보통은 그냥 비워두고 비밀번호로 접속하거나 termux를 사용해도 됩니다. 또는 whoami 명령어를 Termux에서 입력해서 현재 사용자 이름을 확인하세요. (일반적으로 Termux는 기본적으로 사용자 이름 없이 비밀번호만으로 SSH 접속을 허용합니다.)
비밀번호 (Password): Termux에서 passwd로 설정한 비밀번호
key : 컴퓨터의 .ssh\id_rsa

연결에 성공하면, 여러분의 컴퓨터에서 마치 원격 서버에 접속한 것처럼 Termux 환경을 제어할 수 있게 됩니다.

글의 핵심 요약

이번 글에서는 안드로이드 Termux와 SSH 클라이언트를 활용하여 나만의 모바일 개발 환경을 구축하는 방법을 알아보았어요. 이 기술을 통해 얻을 수 있는 핵심적인 이점들을 다시 한번 정리해볼게요!

모바일 워크스테이션: 언제 어디서든 스마트폰만 있으면 코딩할 수 있는 자유를 얻게 됩니다. 마치 주머니 속의 작은 서버를 가지고 다니는 느낌이랄까요?
효율적인 원격 접속: Claude Desktop이나 tufantunc/SSH-MCP 같은 SSH 클라이언트를 사용하면 PC에서 더욱 편리하고 효율적으로 Termux에 접속하여 작업할 수 있어요. 큰 화면과 물리 키보드의 장점을 그대로 누리세요.
다양한 개발 환경 지원: Termux는 Python, Node.js, Git 등 다양한 개발 도구를 지원하여 거의 모든 종류의 프로그래밍 작업을 할 수 있게 해줍니다.
비용 절감 및 휴대성: 고가의 노트북이나 서버 장비 없이도 충분히 강력한 개발 환경을 구축할 수 있어 경제적이며, 스마트폰의 휴대성 덕분에 이동 중에도 아이디어를 코드로 옮길 수 있습니다.

모바일 개발, 이제는 현실!

Termux: 안드로이드 속 리눅스 터미널, APT로 원하는 패키지 설치!

SSH 연동: PC에서 Termux로 원격 접속, 큰 화면에서 코딩!

Claude Desktop/tufantunc/SSH-MCP:

편리한 SSH 클라이언트로 스마트폰에 강력한 개발 환경 구축!

나만의 워크스테이션: 언제 어디서든 코딩 가능, 휴대성과 효율성을 동시에!

스마트폰으로 개발하는 당신의 새로운 시작을 응원합니다!

자주 묻는 질문 ❓

Q: Termux에서 SSH 접속이 잘 안 돼요. 뭐가 문제일까요?

A: 몇 가지 확인할 사항이 있어요.

Termux에서 sshd 명령어가 실행 중인지 확인하세요.
passwd로 비밀번호를 올바르게 설정했는지 확인하세요.
스마트폰과 PC가 같은 네트워크(Wi-Fi)에 연결되어 있는지 확인하세요.
방화벽 설정 때문에 막히는 경우도 있으니 잠시 비활성화하고 시도해 보세요.
Termux가 백그라운드에서 강제로 종료되지 않도록 배터리 최적화 설정을 확인하세요.

Q: tufantunc/SSH-MCP는 어디서 다운로드할 수 있나요?

A: tufantunc/SSH-MCP는 GitHub에서 찾을 수 있는 오픈소스 프로젝트입니다. GitHub에 접속하여 해당 프로젝트를 검색하시면 소스 코드 및 관련 정보를 얻을 수 있습니다. 직접 빌드하거나 배포된 버전을 찾아보셔야 할 수도 있습니다.

Q: Termux에서 코딩할 때 스마트폰 키보드가 너무 불편해요.

A: 맞아요, 그래서 원격 접속이 중요하죠! PC의 물리 키보드를 사용하는 것이 가장 좋지만, 스마트폰에서 직접 입력해야 한다면 Termux의 확장 키보드 설정을 활용하거나, 블루투스 키보드를 연결하는 것을 추천해요. 물리 키보드는 정말 신세계를 열어줄 거예요!

어때요? 이제 여러분의 스마트폰이 단순한 통신 기기를 넘어, 강력한 개발 머신으로 보이기 시작하지 않나요? Claude Desktop, tufantunc/SSH-MCP와 Termux의 조합은 생각보다 훨씬 더 유용하고 재미있는 경험을 제공해 줄 거예요. 더 궁금한 점이 있다면 언제든지 댓글로 물어봐 주세요~