복잡한 설정 없이 시작하는 TMS MCP 서버 설치
쉽게 설치하고 쉽게 활용하는 TMS MCP 서버
시작하며
지난 포스트를 통해 TMS MCP 서버의 개념과 도입 배경을 살펴보았습니다. 이번 포스트에서는 실제로 TMS MCP 서버를 설치하고 바로 활용할 수 있는 방법을 소개합니다.
일반적으로 개발 환경을 구성하는 과정은 여러 설정과 사전 준비가 필요해 시작부터 난관을 마주하게 됩니다. 하지만 TMS MCP 서버는 불필요한 환경 설정을 최소화하고 핵심 과정만으로 빠르게 시작할 수 있도록 설계되었습니다. 이 글에서는 복잡한 설명 대신 설치부터 실행까지의 흐름을 따라가며 TMS MCP 서버를 차근차근 설치하는 과정을 안내해드리겠습니다.
설치 가이드 1. 사전 준비
본 MCP 서버는 MCP 호스트 단에서 구동되는 로컬 MCP 서버로, uvx 명령어로 실행됩니다. 이를 위해 운영체제(OS)에 알맞는 설치 방법을 따라 uv를 설치해주세요.
✅ Windows 설치 방법
1. Win + R 키를 누른 후, 아래 이미지와 같은 창이 뜨면 cmd 입력 후 확인 버튼 클릭
2. 아래 명령어를 입력하여 설치 진행
(Javascript) powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
✅ MacOS 설치 방법
1. Cmd + Space 키를 누른 후, 터미널을 검색하여 검색된 앱 실행
2. 아래 명령어를 입력하여 설치 진행
(Bash) curl -LsSf https://astral.sh/uv/install.sh | sh
설치 가이드 2. 코딩 에이전트 선택
사용하시는 코딩 에이전트에 따라 아래 가이드를 참고하여 MCP 서버를 설치하세요.
� Cursor: 다양한 모델을 선택할 수 있음. (권장 대상) 개발자
� Claude Code: Claude 유료 플랜 필요. (권장 대상) Claude 구독자
� Codex CLI: ChatGPT 유료 플랜 필요. (권장 대상) ChatGPT 구독자
� Gemini CLI: 구글 아이디만 있으면 무료 사용 가능. (권장 대상) 간단한 테스트
설치 가이드 3. API 키 발급
* 아이나비 Maps API 키 발급은 iMPS 회원가입 후 해당 링크를 통해 API 키 발급을 진행해주십시오.
* Omelet Routing API 키 발급은 해당 링크를 통해 가입 후 진행해주십시오.
설치 가이드 4. MCP 서버 설치
사용하시는 코딩 에이전트에 해당하는 설치 가이드에 따라 MCP 서버를 설정해주세요:
✅ Cursor: Cursor > Settings > Cursor Settings > Tools & MCP로 이동한 뒤 아래 내용을 추가하세요.
{
"mcpServers": {
"TMS Development Wizard": {
"command": "uvx",
"args": ["tms-mcp"]
}
}
}
Optional - API 키를 미리 발급 받으면 MCP 서버 설치 단계에서 손쉽게 설정할 수 있습니다.
{
"mcpServers": {
"TMS Development Wizard": {
"command": "uvx",
"args": ["tms-mcp"],
"env": {
"INAVI_API_KEY": "your_inavi_api_key",
"OMELET_API_KEY": "your_omelet_api_key"
}
}
}
}
✅ Claude Desktop (*Claude Desktop은 API 서버에 직접 요청을 전송할 수 없습니다. 엔드포인트와 응답 탐색용으로만 활용하세요.)
1. 터미널에서 uvx 설치 경로를 확인합니다. (macOS 활용 시에만 필요)
* which uvx
2. MCP 설정 JSON 파일을 열고(Claude > Settings > Developer > Edit Config) 아래 내용을 추가합니다.
{
"mcpServers": {
"TMS Development Wizard": {
"command": "uvx",
"args": ["tms-mcp"]
}
}
}
Optional - API 키를 미리 발급 받으면 MCP 서버 설치 단계에서 손쉽게 설정할 수 있습니다.
{
"mcpServers": {
"TMS Development Wizard": {
"command": "uvx",
"args": ["tms-mcp"],
"env": {
"INAVI_API_KEY": "your_inavi_api_key",
"OMELET_API_KEY": "your_omelet_api_key"
}
}
}
}
3. JSON 파일을 저장하고 Claude Desktop을 재시작합니다.
✅ Claude Code: 프로젝트 루트에서 터미널을 열고 실행
(Bash) claude mcp add TMS-Development-Wizard uvx tms-mcp
Optional - API 키를 미리 발급 받으면 MCP 서버 설치 단계에서 손쉽게 설정할 수 있습니다.
(Bash) claude mcp add TMS-Development-Wizard uvx tms-mcp --env INAVI_API_KEY=your_inavi_api_key --env OMELET_API_KEY=your_omelet_api_key
✅ Codex CLI : 프로젝트 루트에서 터미널을 열고 실행
(Bash) codex mcp add TMS-Development-Wizard uvx tms-mcp
Optional - API 키를 미리 발급 받으면 MCP 서버 설치 단계에서 손쉽게 설정할 수 있습니다.
(Bash) codex mcp add TMS-Development-Wizard --env INAVI_API_KEY=your_inavi_api_key --env OMELET_API_KEY=your_omelet_api_key uvx tms-mcp
✅ Gemini CLI: 프로젝트 루트에서 터미널을 열고 실행
(Bash) gemini mcp add TMS-Development-Wizard uvx tms-mcp
Optional - API 키를 미리 발급 받으면 MCP 서버 설치 단계에서 손쉽게 설정할 수 있습니다.
(Bash) gemini mcp add TMS-Development-Wizard uvx tms-mcp --env INAVI_API_KEY=your_inavi_api_key --env OMELET_API_KEY=your_omelet_api_key
마치며
TMS MCP 서버를 통해 생산성 향상을 직접 체감해보시길 바라며, TMS MCP 서버 설치 혹은 이용 중 문의는 아래 컨택 포인트를 통해 문의 바랍니다.
✉️ 대표 문의 | biz@inavi.kr
이준의(Omelet) | juni.lee@omelet.ai
백종훈(iNavi Systems) | devbaek@inavi.kr
—
by 아이나비시스템즈, 그리고 오믈렛
