Node.js Template

git clone https://github.com/ezforgeai/template-nodejs-mcp-server my-server
cd my-server
npm install

my-server/
├── src/
│   └── index.ts        # MCP server — edit this to add your tools
├── Dockerfile          # Multi-stage build for production
├── package.json
├── tsconfig.json
└── ezforge.toml        # Deploy configuration

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'my_tool',
      description: 'Does something useful.',
      inputSchema: {
        type: 'object',
        properties: {
          input: { type: 'string', description: 'Input value.' },
        },
        required: ['input'],
      },
    },
    // ... other tools
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  if (name === 'my_tool') {
    const { input } = args as { input: string };
    // Do something with input
    const result = `Processed: ${input}`;
    return { content: [{ type: 'text', text: result }] };
  }

  throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
});

const apiKey = process.env['MY_API_KEY'];
if (!apiKey) throw new Error('MY_API_KEY is required');

ezforge env set my-server MY_API_KEY=sk-...
ezforge deploy

# Start the server locally
npm run dev

# Test the health check
curl http://localhost:8080/healthz
# {"status":"ok"}

# Build TypeScript
npm run build

# Deploy to ezForge
ezforge deploy

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY tsconfig.json ./
COPY src/ ./src/
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY --from=builder /app/dist ./dist
EXPOSE 8080
CMD ["node", "dist/index.js"]