SeaTalk MCP Server

An MCP server that connects to the SeaTalk Open Platform API, giving you 8 tools:

Tool	What it does
send_direct_message	Send a DM to a SeaTalk user via the bot
send_group_message	Send a message to a group chat
list_groups	List all groups the bot has joined
get_group_info	Get details about a specific group
get_group_history	Read recent messages in a group (up to 7 days)
find_employee_by_email	Look up employee codes by email
get_message	Retrieve a specific message by ID
get_thread_messages	Read messages in a thread

---

Prerequisites

1. Node.js 18+ — Download from nodejs.org (pick LTS)
2. SeaTalk App credentials — From open.seatalk.io:
   • Create an App/Bot
   • Copy your App ID and App Secret
   • Enable messaging and contacts capabilities

---

Quick Start (Local)

# 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

The server starts on http://localhost:3000/sse.

---

Deploy to Railway (Recommended for Non-Devs)

1. Go to railway.app and sign up (free tier available)
2. Click "New Project" → "Deploy from GitHub repo"
3. Connect your GitHub and upload this code (or use "Deploy from local")
4. Go to Variables tab and add:
   • SEATALK_APP_ID = your App ID
   • SEATALK_APP_SECRET = your App Secret
   • PORT = 3000
5. Railway will auto-detect the Dockerfile and deploy
6. Copy the public URL Railway gives you (e.g., your-app.up.railway.app)
7. Your MCP endpoint is: https://your-app.up.railway.app/sse

---

Deploy to Render

1. Go to render.com and sign up
2. Click "New" → "Web Service"
3. Connect your repo or upload code
4. Set Build Command: npm install && npm run build
5. Set Start Command: npm start
6. Add Environment Variables:
   • SEATALK_APP_ID = your App ID
   • SEATALK_APP_SECRET = your App Secret
7. Deploy and copy the URL

---

Connect to Migoo

Once deployed, add it as a custom MCP:

1. Use the URL: https://YOUR-DEPLOYED-URL/sse
2. That's it — the tools will appear automatically

---

Project Structure

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