motionmcp 1.0.0 → 1.0.2

package/README.md

@@ -30,6 +30,44 @@ A Model Context Protocol (MCP) server that provides LLMs with direct access to t
 - Node.js 18 or higher
 - Motion API key (get from https://app.usemotion.com/settings/api)
 
+## Providing Your Motion API Key
+
+The Motion MCP Server supports multiple ways to provide your API key:
+
+### Environment Variable
+```bash
+MOTION_API_KEY=your-key npx motionmcp
+```
+
+### Command Line Arguments
+```bash
+# With API key only
+npx motionmcp --api-key=your-key
+
+# With API key and custom port
+npx motionmcp --api-key=your-key --port=4000
+```
+
+### Config File
+Create a config file in your home directory:
+```bash
+echo '{"apiKey": "your-key", "port": 4000}' > ~/.motionmcp.json
+npx motionmcp
+```
+
+### Interactive Prompt
+If no API key is provided through the above methods, the server will prompt you:
+```bash
+npx motionmcp
+# Will prompt: "Please enter your Motion API key: "
+```
+
+The server checks for the API key in this order:
+1. Environment variable (`MOTION_API_KEY`)
+2. Command line argument (`--api-key=`)
+3. Config file (`~/.motionmcp.json`)
+4. Interactive prompt
+
 ## Installation
 
 1. Clone the repository

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "motionmcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "",
   "main": "index.js",
+  "bin": {
+    "motionmcp": "./src/index.js"
+  },
   "scripts": {
     "start": "node src/index.js",
     "dev": "node src/index.js",

package/src/index.js

@@ -1,6 +1,12 @@
+#!/usr/bin/env node
+
 const express = require('express');
 const cors = require('cors');
 const winston = require('winston');
+const readline = require('readline');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
 require('dotenv').config();
 
 const motionRoutes = require('./routes/motion');
@@ -18,30 +24,156 @@ const logger = winston.createLogger({
   ]
 });
 
-const app = express();
-const PORT = process.env.PORT || 3000;
+// Parse command line arguments
+function parseCommandLineArgs() {
+  const args = process.argv.slice(2);
+  const apiKeyArg = args.find(arg => arg.startsWith('--api-key='));
+  if (apiKeyArg) {
+    process.env.MOTION_API_KEY = apiKeyArg.split('=')[1];
+  }
 
-app.use(cors());
-app.use(express.json());
+  const portArg = args.find(arg => arg.startsWith('--port='));
+  if (portArg) {
+    process.env.PORT = portArg.split('=')[1];
+  }
+}
 
-app.use((req, res, next) => {
-  logger.info(`${req.method} ${req.path}`, { ip: req.ip });
-  next();
-});
+// Check for config file in user's home directory
+function loadConfigFile() {
+  const configPath = path.join(os.homedir(), '.motionmcp.json');
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      if (config.apiKey && !process.env.MOTION_API_KEY) {
+        process.env.MOTION_API_KEY = config.apiKey;
+      }
+      if (config.port && !process.env.PORT) {
+        process.env.PORT = config.port;
+      }
+    } catch (err) {
+      logger.warn('Failed to parse config file:', err.message);
+    }
+  }
+}
 
-app.get('/health', (req, res) => {
-  res.json({ status: 'ok', timestamp: new Date().toISOString() });
-});
+// Interactive prompt for API key
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question('Please enter your Motion API key: ', (answer) => {
+      rl.close();
+      const apiKey = answer.trim();
+      if (apiKey) {
+        process.env.MOTION_API_KEY = apiKey;
+      }
+      resolve(apiKey);
+    });
+  });
+}
+
+// Get API key from various sources
+async function getApiKey() {
+  // Check if already set in environment
+  if (process.env.MOTION_API_KEY) {
+    return process.env.MOTION_API_KEY;
+  }
+
+  // Parse command line arguments
+  parseCommandLineArgs();
+  if (process.env.MOTION_API_KEY) {
+    return process.env.MOTION_API_KEY;
+  }
+
+  // Load from config file
+  loadConfigFile();
+  if (process.env.MOTION_API_KEY) {
+    return process.env.MOTION_API_KEY;
+  }
+
+  // Prompt user interactively
+  logger.info('No API key found in environment variables, command line args, or config file.');
+  const apiKey = await promptForApiKey();
+  return apiKey;
+}
+
+// Initialize and start the server
+async function startServer() {
+  try {
+    const apiKey = await getApiKey();
+
+    if (!apiKey) {
+      logger.error('API key is required to run Motion MCP Server');
+      logger.info('You can provide it via:');
+      logger.info('  Environment variable: MOTION_API_KEY=your-key npx motionmcp');
+      logger.info('  Command line arg: npx motionmcp --api-key=your-key');
+      logger.info('  Config file: echo \'{"apiKey": "your-key"}\' > ~/.motionmcp.json');
+      process.exit(1);
+    }
 
-app.use('/api/motion', motionRoutes);
+    logger.info('Motion API key configured successfully');
 
-app.use((err, req, res, next) => {
-  logger.error('Unhandled error:', err);
-  res.status(500).json({ error: 'Internal server error' });
+    const app = express();
+    const PORT = process.env.PORT || 3000;
+
+    app.use(cors());
+    app.use(express.json());
+
+    // Add API key to request context
+    app.use((req, res, next) => {
+      req.motionApiKey = process.env.MOTION_API_KEY;
+      next();
+    });
+
+    app.use((req, res, next) => {
+      logger.info(`${req.method} ${req.path}`, { ip: req.ip });
+      next();
+    });
+
+    app.get('/health', (req, res) => {
+      res.json({
+        status: 'ok',
+        timestamp: new Date().toISOString(),
+        hasApiKey: !!process.env.MOTION_API_KEY
+      });
+    });
+
+    app.use('/api/motion', motionRoutes);
+
+    app.use((err, req, res, next) => {
+      logger.error('Unhandled error:', err);
+      res.status(500).json({ error: 'Internal server error' });
+    });
+
+    app.listen(PORT, () => {
+      logger.info(`Motion MCP Server running on port ${PORT}`);
+      logger.info(`Health check available at http://localhost:${PORT}/health`);
+    });
+
+    return app;
+  } catch (error) {
+    logger.error('Failed to start server:', error);
+    process.exit(1);
+  }
+}
+
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+  logger.info('Received SIGINT, shutting down gracefully');
+  process.exit(0);
 });
 
-app.listen(PORT, () => {
-  logger.info(`Motion MCP Server running on port ${PORT}`);
+process.on('SIGTERM', () => {
+  logger.info('Received SIGTERM, shutting down gracefully');
+  process.exit(0);
 });
 
-module.exports = app;
+// Start the server if this file is run directly
+if (require.main === module) {
+  startServer().catch(console.error);
+}
+
+module.exports = { startServer };