철도 MCP 서버

Railway.app 플랫폼과 통합하기 위한 MCP(Model Context Protocol) 서버입니다.

목차

특징

• ✅ 철도 API 토큰을 통한 인증
• ✅ 프로젝트 관리(목록, 정보, 삭제)
• ✅ 배포 관리(목록, 재시작)
• ✅ 서비스 관리(GitHub 리포지토리 또는 Docker 이미지에서 생성, 목록)
• ✅ 변수 관리(목록, 생성/업데이트, 삭제)
• ✅ 서비스 네트워크 관리
• ✅ 볼륨 관리
• ❌ 모든 템플릿에 대한 완벽한 지원
  • 🚧🔨⏳ 데이터베이스 템플릿 지원
  • 자동 데이터베이스 및 네트워킹 워크플로
• 🚧🔨⏳ 가장 일반적으로 사용되는 워크플로
• ❌ 서비스에 대한 자동 GitHub 저장소 연결

설치

필수 조건

• Node.js 18+(기본 제공 Fetch API 지원용)
• 활성화된 철도 계정
• 철도 API 토큰( https://railway.app/account/tokens 에서 생성)

빠른 시작

이 MCP 서버는 다음과 같은 MCP 클라이언트와 함께 작동하도록 설계되었습니다.

• 데스크톱용 Claude | ✅ 실전 테스트 완료
• 커서 | ✅ 테스트 필요
• 클라인 | 🚧🔨⏳ 테스트 필요
• 윈드서핑 | 🚧🔨⏳ 테스트 필요
• 다른 MCP 클라이언트 | 🚧🔨⏳ 테스트 필요

Smithery를 통해 설치

railway-mcp를 자동으로 설치하려면 Smithery를 사용하는 것이 좋습니다.

클로드 데스크탑

지엑스피1

커서

1. 커서 설정으로 이동하여 MCP 섹션을 찾으세요.
2. '새로운 MCP 서버 추가'를 클릭하세요
3. 원하는 대로 이름을 지정하세요. 명확성을 위해 railway-mcp 권장합니다.
4. 이 명령을 '명령' 섹션에 붙여넣습니다. 여기서 <RAILWAY_API_TOKEN>은 귀하의 계정 철도 토큰입니다.

1. Claude for Desktop 구성 파일을 만들거나 편집하세요.
   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. API 토큰을 사용하여 railway-mcp 서버를 구성에 추가합니다.

여러 개의 MCP 서버가 있는 경우 구성 파일은 다음과 같습니다.

3. 데스크톱용 Claude 재시작
4. 이제 Claude에서 Railway 도구를 바로 사용할 수 있습니다. 예:

5. 또는 구성 파일에 토큰을 추가하지 않으려면 다음을 사용하여 Claude 내에서 구성할 수 있습니다.

추천 및 기타 정보

이 서버는 터미널이나 Git (Cursor, Windsurf) 에 접근할 수 있는 MCP 클라이언트와 가장 잘 결합됩니다. railway-mcp는 컨테이너를 조율하고 배포 프로세스를 원활하게 간소화하므로 다른 MCP와 함께 사용하는 것이 좋습니다.

결합할 권장 MCP 서버

• Git || 공식 링크
• GitHub || 공식 || Smithery

클로드에게

• 기본적으로 Claude는 터미널 접근 권한이 없으므로 최신 커밋을 가져올 수 없으므로 배포를 트리거할 수 없습니다.
• 다양한 서비스를 시작하고 모니터링하는 것이 Claude를 가장 잘 활용하는 사례입니다.

커서용

• GitHub MCP와 함께 사용하거나 GitHub에 저장소를 이미 설정하고 로컬 컴퓨터에 복제하여 railway-mcp와 완벽하게 통합할 수 있습니다.
• Cursor가 변경 작업을 할 때, GitHub에 변경 사항을 푸시하는 것을 잊어서 Railway가 가져올 수 없는 커밋을 배포하려고 할 수 있습니다.
  • 해결책: 항상 질문하거나 프롬프트에 다음을 포함하세요: Have you pushed our changes to GitHub yet?

보안 고려 사항

• 철도 API 토큰은 계정에 대한 모든 권한을 제공합니다. 안전하게 보관하세요.
• 환경 변수 방법을 사용하면 토큰은 Claude Desktop 구성 파일에 저장됩니다.
• 민감한 변수 값은 표시될 때 자동으로 마스크됩니다.
• 모든 API 호출은 보안 통신을 위해 HTTPS를 사용합니다.
• 서버의 메모리 전용 토큰 저장소는 토큰이 구성 파일 외부의 디스크에 기록되지 않는다는 것을 의미합니다.

문제 해결

문제가 발생하는 경우:

1. 토큰 인증 문제
   • API 토큰이 유효하고 필요한 권한이 있는지 확인하세요.
   • 환경 변수 방법을 사용하는 경우 토큰이 구성 파일에서 올바르게 형식화되었는지 확인하세요.
   • 환경 토큰이 작동하지 않는 경우 Claude에서 직접 configure 도구를 사용해 보세요.
2. 서버 연결 문제
   • 최신 버전의 서버를 설치했는지 확인하세요
   • Node.js 버전 18 이상이 설치되어 있는지 확인하세요.
   • 구성을 변경한 후 Claude for Desktop을 다시 시작하세요.
3. API 오류
   • 올바른 프로젝트, 환경 및 서비스 ID를 사용하고 있는지 확인하세요.
   • 서비스 중단이 있는지 철도 상태 페이지를 확인하세요.
   • 철도 API에는 속도 제한이 있습니다. 짧은 기간 내에 너무 많은 요청을 하지 마십시오.

기여하다

커뮤니티 여러분의 참여를 환영합니다! 시작 방법, 개발 지침, 디버깅 정보 등에 대한 자세한 내용은 기여 가이드라인을 참조하세요.

사용 가능한 도구

입증

• configure - 철도 API 토큰을 설정합니다(환경 변수에 제공되지 않은 경우에만 필요)

프로젝트

• project-list - 계정의 모든 프로젝트 나열
• project-info - 특정 프로젝트에 대한 자세한 정보를 얻습니다.
• project-create - 선택적 팀 ID로 새 프로젝트를 만듭니다.
• project-delete - 프로젝트 삭제
• project-environments - 프로젝트의 모든 환경 나열

서비스

• service-list - 특정 프로젝트의 모든 서비스 나열
• service-info - 특정 서비스에 대한 자세한 정보를 얻습니다.
• service-create-from-repo - GitHub 저장소에서 새 서비스 만들기
• service-create-from-image - Docker 이미지에서 새 서비스 만들기
• service-delete - 프로젝트에서 서비스 삭제
• service-restart - 특정 환경에서 서비스를 다시 시작합니다.
• service-update - 서비스 구성 업데이트(빌드 명령, 시작 명령 등) | 🚧 테스트 필요

배포

• deployment-list - 서비스에 대한 최근 배포 목록
• deployment-trigger - 서비스에 대한 새 배포를 트리거합니다.
• deployment-logs - 특정 배포에 대한 로그 가져오기
• deployment-health-check - 배포 상태 확인

변수

• variable-list - 서비스 또는 환경에 대한 변수 나열
• variable-set - 변수 생성 또는 업데이트
• variable-delete - 변수 삭제
• variable-bulk-set - 서비스의 변수 대량 업데이트 | 🚧 테스트 필요
• variable-copy - 환경 간 변수 복사 | 🚧 테스트 필요

데이터베이스

• database-list-types - 배포 가능한 모든 데이터베이스 유형을 나열합니다.
• database-deploy - 새로운 데이터베이스 서비스 배포

새로운 서비스 설정

1. 프로젝트 ID를 얻으려면 프로젝트를 나열하세요.
2. 템플릿에서 새 서비스 만들기
3. 환경 변수 추가
4. 서비스 배포 보기

환경 변수 관리

1. 프로젝트 ID를 찾으려면 프로젝트를 나열하세요.
2. 현재 설정된 내용을 보려면 변수 목록을 확인하세요.
3. 필요에 따라 변수를 생성하거나 업데이트합니다.
4. 더 이상 사용되지 않는 변수를 삭제하세요