목차(클릭하세요)
1. MCP환경 셋팅
•
기본적으로 파이썬, VSC는 설치되어있다고 하고 Pass!!•
1-1. Claude 데스크탑 버전 설치
•
당연히 클로드 계정은 있어야 하고, 사용법을 읽고 싶다면 아래 링크 클릭
1-2.초기 셋팅
•
왼쪽 상단의 파일설정 메뉴에서 개발자클릭 후, ‘설정편집’을 클릭
•
단축키: ctrl + ,
•
claude_desctop_config.json 파일을 메모장으로 열기
◦
VSC나 다른 편집기가 있다면 활용가능
◦
초기에는 아무 내용이 없고 {}중괄호만 존재
1-3.추가 프로그램
•
Node.js 설치하기: 
Node.js — Node.js® 다운로드
Node.js — Node.js® 다운로드Node.js의 버전이 너무 낮은 경우, MCP 서버가 작동되지 않을 수 있으니, 낮은 버전을 삭제후 LSTM버전으로 재설치해야 함!!
Node.js 설치가 필요한 이유
이유 | 설명 |
1. MCP SDK의 기반 환경 | MCP 서버 개발에 사용되는 공식 SDK인 @modelcontextprotocol/sdk는 TypeScript로 작성되어 있으며, Node.js 환경에서 실행됨
따라서 MCP 서버를 구축하려면 Node.js가 필요 |
2. MCP 서버 실행을 위한 런타임 | MCP 서버는 Node.js 런타임에서 실행되며, Claude Desktop과 같은 클라이언트와의 통신을 위해 stdio 또는 HTTP(SSE)와 같은 전송 방식을 사용 |
3. 의존성 관리 및 빌드 도구 제공 | Node.js는 npm을 통해 MCP SDK 및 관련 라이브러리의 설치와 관리, TypeScript 코드의 빌드 등을 지원하기 때문 |
•
Node.js 설치 확인: CMD에서 node --version 입력해보기
node --version
Bash
복사
MCP 서버 구축을 위한 필수 구성 요소
구성 요소 | 설명 |
Node.js | MCP 서버 실행을 위한 JavaScript 런타임 환경 |
npm | Node.js 패키지 관리자이며, MCP SDK 및 관련 패키지의 설치와 관리를 담당 |
TypeScript | MCP SDK는 TypeScript로 작성되어 있으며, 이를 JavaScript로 컴파일하여 실행 |
MCP SDK (@modelcontextprotocol/sdk) | MCP 서버 및 클라이언트 개발을 위한 공식 SDK |
2. MCP 서버 설정하기
MCP마다 설치&설정하는 방법이 약간 다름 초보자들의 진입장벽이 될 듯
초보자들의 진입장벽이 될 듯•
USB 포트에 장치를 꽂아 넣듯 MCP 서버와 클로드를 연결하는 작업
2-1. 클로드 데스크탑 json 파일열기
•
claude_desctop_config.json 파일을 수정하는 방식
2-2.MCP 서버 설정하기: server-filesystem
•
파일에 MCP서버를 추가하기
•
cmd창을 열고 다음 명령어를 통해 해당 서버 설치하기
npm install -g @modelcontextprotocol/server-filesystem
Bash
복사
2-3.연습하기
•
많은 MCP서버 중에 클로드가 컴퓨터 내부의 폴더를 읽고 쓸 수 있는 서버를 추가하기
•
아래 코드에서 클로드가 사용할 폴더 경로를 추가해야함!
◦
당연히 보완적인 측면에서도 클로드가 모든 폴더를 접근하게 되면.. 윈도우 파일이 손상될수도 있으니까??
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"여기에 접근권한을 줄 폴더명 추가"
]
}
}
}
JSON
복사
! 주의: 여러 폴더를 추가하려면 쉼표로 구분, 경로는 반드시 "" 따옴표로 감싸기
Windows라면 역슬래시 \ 혹은 원화표시를 두 번씩 입력해야 함
•
원화표시 2번을 사용하는 방식: 모든 폴더 경로앞에 원화표시 2번
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\ysj\\desktop\\test_물품구입,도서신청"
]
}
}
}
JSON
복사
•
슬래쉬를 사용하는 방식: “c:”는 삭제해야 함
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/ysj/desktop/test_물품구입,도서신청"
]
}
}
}
JSON
복사
•
파일을 저장한 후, Claude Desktop을 다시 시작하기
◦
오른쪽 상단의 ‘x’창이나, close로 창을 닫지 말고, 파일버튼을 눌러 완전히 종료한 뒤 다시 실행해야 함
•
입력창 하단에 망치 아이콘이 나왔는지 확인
•
이렇게 망치모양의 아이콘이 보이고 마우스를 가져가면, 접근 가능한 파일명이 보임—> 이로써 클로드가 해당 폴더에 있는 파일을 읽고 쓸 수 있게 됨
3. 사용 예시
3-1. pdf파일 수합 후 새로운 최종본 파일 생성
•
이 기능은 예전에도 gpt나 클로드에서 가능했으나, 뭔가 불완전 했음
•
특히 한글파일명을 업로드하면, 오래 걸리고, 케바케로 되다가 안되다가..
•
느낌상 한글 hwp를 잘 다루는 MCP서버가 있을 것 같아, 먼저 pdf로 테스트 진행
•
MCP를 본격적으로 사용하기 위한 권한 허용 필요
•
뭔가 오류가나면 새로운 방법으로 다시 시도하고, 또 도전하는 아름다운 모습!!
•
결과물 확인: 한글파일은 여전히.. 헤맴
◦
한글파일, 엑셀파일, 노션 등 다양한 MCP서버를 사용해야 할 듯!!•
하지만 pdf파일이라면?
•
MCP가 아닌 일반 LLM이였다면 그냥 말로 설명하고 끝났을 테지만
•
MCP는 실제 파이썬 실행파일까지 다 만들어 놓고, ‘딸각’만 하면 끝나도록 준비해줌
•
cmd에서 해당 파이썬 파일만 실행하면 OK!
•
느낌상 pdf를 잘 다루는 MCP서버가 있을 듯 한데?3-2.유튜브 자막을 기반으로 영상 내용을 분석해주는 MCP서버
•
MCP서버 명칭: Youtube Transcribe Server
•
아래 내용을 claude_desktop_config.json 파일에 추가하기
◦
주의점: 이미 mcpServers에 filesystem 서버가 설정되어 있으니, 그 밑에 병렬로 추가해야 함
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
JSON
복사
•
병렬로 MCP를 추가할때, 따옴표, 중괄호 에러 조심
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\dvbeetle\\Documents\\obsidian"
]
},
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
JSON
복사
•
2개 이상의 MCP 서버가 제대로 설정되었는지 확인하기
이렇게 설치된 MCP서버를 확인해보기
클로드에게 유튜브 링크를 전달해주면, 알아서 자막을 분석해 원하는 대답을 해줌•
영상 링크와 함께 평소 글쓰는 스타일을 참고해 이에 맞추어 글을 노션 템플릿, 또는 마크다운 형식으로 작성해달라고 요청하기
결과물 개요
•
HWP(한글) 문서를 MCP 서버로 만들어 AI 도구와 연동하는 방법 소개
•
윈도우 환경에서 실행 (HWP는 윈도우에서만 실행 가능)
•
Claude Desktop과 Cursor AI 모두와 연동 가능
준비물
•
Claude Desktop
•
Cursor AI
•
HWP-MCP 서버 코드
설치 및 연동 방법
1. MCP 서버 설치
•
GitHub에서 코드 클론: https://github.com/[저자의 레포지토리]/HWP-MCP
•
클론한 폴더 내 필요한 파일:
◦
HWP 컨트롤러 파일 (tools 폴더 내 위치)
•
requirements.txt로 필요한 패키지 설치
•
서버 실행하여 정상 작동 확인
2. Claude Desktop과 연동
1.
Claude Desktop 실행
2.
설정 → 개발자 → 설정 편집
3.
config 파일에서 HWP 주소 추가/변경
•
대시(-) 표현 시 시프트 옆 대시 사용 권장
4.
Claude 재시작
5.
"핑" 명령어로 "HWP퐁" 응답 확인 → 연결 성공
3. Cursor AI와 연동
1.
Cursor AI 설정 열기
2.
MCP → Add
3.
Claude Desktop과 동일한 주소 입력
4.
Cursor AI 재시작
5.
MCP 서버 등록 성공 시 초록색 표시 확인
기능 및 사용 예시
•
한글 문서 자동 생성 및 편집
•
글자 크기 설정 (제목/본문)
•
내용 자동 삽입
•
행시 작성 및 저장
•
AI 응답 결과를 한글 문서로 변환
현재 제한사항
•
표 생성 기능 미구현
•
제목 크기 변경 오류 존재
참여 방법
•
GitHub 레포지토리를 통해 기능 개선 가능
•
한글 문서 자동화에 관심 있는 개발자는 Pull Request 환영
4. 확인사항
4-1. 클라우드 드라이브 파일도 MCP로 불러올 수 있을까?
•
안됨
•
되는게 더 이상한데?? 클라우드 드라이브 폴더에 접근할 수 있는 MCP가 나오면 가능할 듯
4-2. 무료 계정 여러개를 붙여서 사용 가능?
•
몇번 헤매기 시작하면 사용량 초과를 금방 보게 되다보니…
•
개인계정과 학교 계정을 번갈아 가면서 사용가능!!
•
특히, 이 구글 계정 로그인 창의 주소를 복사하여, 다른 계정에서 로그인하면 Good Job!!
