nodejs-mcp-mongodb

Simple MCP (Model Context Protocol) server built with Node.js, TypeScript, the official MCP SDK, and MongoDB.

Features

This server provides three MCP tools:

1. get_business_summary

   • Returns:

     • total users

     • active users

     • paid users

     • pending payments

     • new users (last 7 days)

2. get_new_users

   • Input:

     • days (number)

   • Returns users created during the given period.

3. get_pending_payments

   • Returns all customers with pending payments.

Related MCP server: jobs-mcp-server

Project Structure

• src/index.ts - MCP server and tool handlers

• src/config/env.ts - environment loading

• src/db/mongo.ts - MongoDB connection helper

• src/services/users.ts - MongoDB queries for tool responses

• seed/seed.ts - sample MongoDB seed script

• .env.example - required environment variables

Setup

1. Install dependencies:

npm install

2. Create your env file:

cp .env.example .env

3. Update .env values:

MONGODB_URI=mongodb://localhost:27017
MONGODB_DB_NAME=mcp_business

4. Seed sample data:

npm run seed

5. Build the server:

npm run build

6. Run the MCP server over stdio:

npm start

Development

Run directly with TypeScript:

npm run dev