Remote Child Story MCP

Remote MCP server for generating short bedtime stories for 3-year-old children.

This project is designed for cloud deployment on Render and exposes one MCP tool:

• generate_story

  • theme: optional story theme

  • child_name: optional child name to include in the story

Endpoints

• GET /health

• POST /mcp

Local Development

npm install
npm run build
npm start

The server listens on PORT and loads environment variables from .env.local or .env when present.

Environment Variables

PORT=3000
ARK_API_KEY=your_ark_api_key
ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
ARK_MODEL=your_model_id
ARK_TIMEOUT_MS=45000

Render Deployment

Create a new Render Web Service and use:

• Runtime: Node

• Build Command: npm install && npm run build

• Start Command: npm start

• Health Check Path: /health

Required environment variables on Render:

• ARK_API_KEY

• ARK_BASE_URL

• ARK_MODEL

• ARK_TIMEOUT_MS

After deployment, use the Render app URL with /mcp as the remote MCP endpoint.

Verification

npm test
npm run check
npm run build