World Weather Online — MCP 서버 (Railway)

World Weather Online을 위한 MCP 서버입니다. Claude, Cursor 및 기타 AI 어시스턴트가 WWO 날씨 데이터를 도구로 직접 호출할 수 있게 해줍니다.

Railway에 배포하기

1단계 — GitHub에 푸시

1. github.com에 새 저장소를 만듭니다 (이름: wwo-mcp-server)

2. 이 폴더에서 터미널을 열고 다음을 실행합니다:

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USERNAME/wwo-mcp-server.git
git push -u origin main

2단계 — Railway에 배포

1. https://railway.app 에 접속하여 GitHub 계정으로 가입/로그인합니다.

2. New Project → Deploy from GitHub repo를 클릭합니다.

3. wwo-mcp-server 저장소를 선택합니다.

4. Railway가 Node.js를 자동으로 감지하고 배포합니다.

서버는 다음과 같은 URL에서 라이브 상태가 됩니다:

https://wwo-mcp-server-production.up.railway.app

3단계 — 사용자 지정 도메인 추가

1. Railway 대시보드 → 프로젝트 → Settings → Networking → Custom Domain으로 이동합니다.

2. mcp.worldweatheronline.com을 입력하고 Add를 클릭합니다.

3. Railway가 다음과 같은 CNAME 값을 보여줍니다:

   wwo-mcp-server-production.up.railway.app

4. DNS 제공업체로 이동하여 다음을 추가합니다:

   유형	이름	값
   CNAME	mcp	wwo-mcp-server-production.up.railway.app

5. SSL 인증서가 몇 분 내에 자동으로 프로비저닝됩니다.

4단계 — 테스트

상태 엔드포인트를 방문하세요:

https://mcp.worldweatheronline.com/health

MCP Inspector에서 테스트하세요:

https://mcp.worldweatheronline.com/mcp?key=YOUR_WWO_API_KEY

AI 클라이언트 연결

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Cursor / Windsurf

.cursor/mcp.json에 추가하세요:

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}

사용 가능한 도구

로컬 개발

npm install
npm run dev

서버는 http://localhost:3000에서 실행됩니다