SeaTalk MCP 서버

SeaTalk 오픈 플랫폼 API에 연결하는 MCP 서버로, 8가지 도구를 제공합니다:

사전 요구 사항

1. Node.js 18+ — nodejs.org에서 다운로드 (LTS 선택)

2. SeaTalk 앱 자격 증명 — open.seatalk.io에서:

   • 앱/봇 만들기

   • App ID 및 App Secret 복사

   • 메시징 및 연락처 기능 활성화

Related MCP server: DingTalk MCP Server

빠른 시작 (로컬)

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Set your credentials and run
SEATALK_APP_ID=your_id SEATALK_APP_SECRET=your_secret npm start

서버는 http://localhost:3000/sse에서 시작됩니다.

Railway에 배포 (개발자가 아닌 사용자에게 권장)

1. railway.app에 접속하여 가입 (무료 티어 제공)

2. "New Project" 클릭 → "Deploy from GitHub repo"

3. GitHub를 연결하고 이 코드를 업로드 (또는 "Deploy from local" 사용)

4. Variables 탭으로 이동하여 추가:

   • SEATALK_APP_ID = 본인의 App ID

   • SEATALK_APP_SECRET = 본인의 App Secret

   • PORT = 3000

5. Railway가 Dockerfile을 자동으로 감지하여 배포합니다

6. Railway가 제공하는 공개 URL을 복사 (예: your-app.up.railway.app)

7. MCP 엔드포인트: https://your-app.up.railway.app/sse

Render에 배포

1. render.com에 접속하여 가입

2. "New" 클릭 → "Web Service"

3. 저장소를 연결하거나 코드 업로드

4. Build Command 설정: npm install && npm run build

5. Start Command 설정: npm start

6. 환경 변수 추가:

   • SEATALK_APP_ID = 본인의 App ID

   • SEATALK_APP_SECRET = 본인의 App Secret

7. 배포하고 URL 복사

Migoo에 연결

배포가 완료되면 커스텀 MCP로 추가:

1. URL 사용: https://YOUR-DEPLOYED-URL/sse

2. 끝입니다 — 도구가 자동으로 나타납니다

프로젝트 구조

seatalk-mcp-server/
├── src/
│   └── index.ts      ← Main server code (all tools + API client)
├── package.json       ← Dependencies
├── tsconfig.json      ← TypeScript config
├── Dockerfile         ← For Docker-based deploys
├── Procfile           ← For Railway/Heroku
├── .env.example       ← Template for env vars
└── README.md          ← This file