neerajp926/status-mcp-server

Status MCP Server

A modular MCP (Model Context Protocol) server with service status monitoring tools, designed for easy extension with additional tools.

Features

• ✅ Modular Architecture: Easy to add new tools
• 🔍 Service Status Monitoring: Get real-time status information
• 🛠️ Extensible Design: Template-based tool creation
• 📦 LM Studio Ready: Pre-configured for LM Studio integration

Quick Start

1. Install Dependencies

cd status-mcp-server
npm install

2. Configure LM Studio

Add this configuration to your LM Studio MCP settings:

{
  "mcpServers": {
    "status-mcp-server": {
      "command": "node",
      "args": ["/Users/neeraj/workspace/MCP_SERVER/status-mcp-server/src/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Important: Update the path in args to match your installation location.

3. Start Using

Restart LM Studio and you'll have access to the get_service_status tool.

Available Tools

get_service_status

Get current status of the MCP service and optional system information.

Parameters:

• include_system_info (boolean, optional): Include detailed system info

Example:

// Basic status
get_service_status()

// With system info  
get_service_status({ include_system_info: true })

Architecture

status-mcp-server/
├── src/
│   ├── index.js           # Main server entry point
│   └── tools/
│       ├── index.js       # Tool registry
│       └── statusTool.js  # Status monitoring tool
├── config/
│   ├── lm-studio-config.json  # LM Studio configuration
│   └── README.md             # Setup instructions
├── examples/
│   └── new-tool-template.js  # Template for new tools
└── package.json

Adding New Tools

Step 1: Create Your Tool

Use the template in examples/new-tool-template.js:

// src/tools/myNewTool.js
export class MyNewTool {
  constructor() {
    this.name = "my_new_tool";
    this.description = "What my tool does";
    this.inputSchema = {
      type: "object",
      properties: {
        // Define parameters
      }
    };
  }

  async execute(args = {}) {
    // Tool implementation
    return {
      content: [{ type: "text", text: "Result" }]
    };
  }

  getToolDefinition() {
    return {
      name: this.name,
      description: this.description,
      inputSchema: this.inputSchema
    };
  }
}

Step 2: Register Your Tool

Add to src/tools/index.js:

import { MyNewTool } from './myNewTool.js';

export const tools = {
  statusTool: new StatusTool(),
  myNewTool: new MyNewTool()  // Add here
};

Step 3: Restart Server

Your new tool will be automatically available to MCP clients.

Development

Run in Development Mode

npm run dev  # Auto-restarts on file changes

Manual Testing

npm start    # Runs server in stdio mode

Extension Ideas

• Process Monitoring: Monitor running processes
• File System Tools: Directory listing, file operations
• Network Tools: Port scanning, connectivity checks
• Database Tools: Connection testing, query execution
• API Tools: HTTP requests, webhook handling

License

MIT