ms365-mcp-server 1.1.5 → 1.1.7

package/README.md

@@ -38,6 +38,9 @@ ms365-mcp-server --login
 
 # Start the server
 ms365-mcp-server
+
+# Start with custom server URL
+ms365-mcp-server --server-url https://your-domain.com
 ```
 
 **Option B: Run with npx (no installation needed)**
@@ -47,6 +50,9 @@ npx ms365-mcp-server --login
 
 # Start the server
 npx ms365-mcp-server
+
+# Start with custom server URL
+npx ms365-mcp-server --server-url https://your-domain.com
 ```
 
 ### 2. SIYA Desktop Integration
@@ -57,7 +63,7 @@ npx ms365-mcp-server
   "mcpServers": {
     "ms365": {
       "command": "ms365-mcp-server",
-      "args": []
+      "args": ["--server-url", "https://your-domain.com"]
     }
   }
 }
@@ -69,7 +75,7 @@ npx ms365-mcp-server
   "mcpServers": {
     "ms365": {
       "command": "npx",
-      "args": ["ms365-mcp-server"]
+      "args": ["ms365-mcp-server", "--server-url", "https://your-domain.com"]
     }
   }
 }
@@ -84,6 +90,16 @@ Chat with SIYA and ask it to help with your emails! The tools are designed for n
 ```bash
 # One-command authentication
 ms365-mcp-server --login
+
+# Authentication with custom server URL
+ms365-mcp-server --login --server-url https://your-domain.com
+```
+
+### Environment Variables
+```bash
+# Set server URL via environment variable
+export SERVER_URL=https://your-domain.com
+ms365-mcp-server
 ```
 
 ### MCP Tool Authentication
@@ -381,4 +397,34 @@ Contributions welcome! Please submit issues and pull requests.
 
 **Built with 🔒 Security and ❤️ for the AI community**
 
-*Production-ready Microsoft 365 integration for SIYA Desktop and MCP applications*
+*Production-ready Microsoft 365 integration for SIYA Desktop and MCP applications*
+
+## 🔧 Configuration Options
+
+### Server Configuration
+- `--server-url URL`: Set custom server URL for attachments and authentication (default: http://localhost:55000)
+- `SERVER_URL`: Environment variable to set server URL
+
+### Authentication Options
+- `--setup-auth`: Set up MS365 API credentials
+- `--reset-auth`: Clear stored authentication tokens
+- `--multi-user`: Enable multi-user authentication mode
+- `--login`: Login to MS365
+- `--logout`: Logout from MS365
+- `--verify-login`: Verify login status
+
+### General Options
+- `--debug`: Enable debug output
+- `--non-interactive`, `-n`: Run in non-interactive mode (no prompt)
+- `--help`, `-h`: Show help message
+
+## 📝 Notes
+
+- The server URL is used for:
+  1. Serving email attachments
+  2. Generating attachment URLs
+  3. OAuth redirect URIs
+  4. Authentication callbacks
+- Attachments are served for 24 hours before automatic cleanup
+- Default server port is 55000
+- For production use, set a custom server URL with HTTPS

package/bin/cli.js

@@ -63,6 +63,7 @@ let multiUser = false;
 let login = false;
 let logout = false;
 let verifyLogin = false;
+let serverUrl = process.env.SERVER_URL || 'http://localhost:55000';
 
 // Detect if we're running under an MCP context (Claude/SIYA/ChatGPT/etc.)
 const isMcpContext = 
@@ -104,6 +105,14 @@ for (let i = 0; i < args.length; i++) {
   } else if (arg === '--verify-login') {
     verifyLogin = true;
     writeDebug('Verify login mode enabled');
+  } else if (arg === '--server-url') {
+    if (i + 1 < args.length) {
+      serverUrl = args[++i];
+      writeDebug(`Server URL set to: ${serverUrl}`);
+    } else {
+      console.error('Error: --server-url requires a value');
+      process.exit(1);
+    }
   } else if (arg === '--help' || arg === '-h') {
     console.log(`
 MS365 MCP Server - Microsoft 365 Integration for Claude/SIYA Desktop
@@ -117,6 +126,7 @@ Options:
   --login                    Login to MS365
   --logout                   Logout from MS365
   --verify-login             Verify login to MS365
+  --server-url URL           Set the server URL (default: http://localhost:55000)
   --debug                    Enable debug output
   --non-interactive, -n      Run in non-interactive mode (no prompt)
   --help, -h                 Show this help message
@@ -134,6 +144,7 @@ Authentication Setup:
      - MS365_CLIENT_SECRET: Your Azure app client secret
      - MS365_TENANT_ID: Your Azure tenant ID (or "common")
      - MS365_REDIRECT_URI: OAuth redirect URI (optional)
+     - SERVER_URL: Server URL for attachments (optional)
 
   2. Credentials File:
      - Run --setup-auth for interactive setup
@@ -158,6 +169,7 @@ Examples:
   npx ms365-mcp-server                 # Start the server
   npx ms365-mcp-server --multi-user    # Start in multi-user mode
   npx ms365-mcp-server --reset-auth    # Clear auth tokens
+  npx ms365-mcp-server --server-url https://your-domain.com  # Set custom server URL
 `);
     process.exit(0);
   }
@@ -203,6 +215,7 @@ function startServerWithPath(serverPath) {
   if (verifyLogin) serverArgs.push('--verify-login');
   if (debug) serverArgs.push('--debug');
   if (nonInteractive) serverArgs.push('--non-interactive');
+  if (serverUrl) serverArgs.push('--server-url', serverUrl);
   
   writeDebug(`Server arguments: ${serverArgs.join(' ')}`);
   
@@ -213,6 +226,7 @@ function startServerWithPath(serverPath) {
       ...process.env,
       // Ensure environment variables are passed through
       NODE_PATH: process.env.NODE_PATH || '',
+      SERVER_URL: serverUrl
     }
   });
   

package/dist/index.js

@@ -16,7 +16,17 @@ import { multiUserMS365Auth } from './utils/multi-user-auth.js';
 import { enhancedMS365Auth } from './utils/ms365-auth-enhanced.js';
 // Create singleton MS365Operations instance
 const ms365Ops = new MS365Operations();
-let ms365Config;
+let ms365Config = {
+    setupAuth: false,
+    resetAuth: false,
+    debug: false,
+    nonInteractive: false,
+    multiUser: false,
+    login: false,
+    logout: false,
+    verifyLogin: false,
+    serverUrl: process.env.SERVER_URL || 'http://localhost:55000'
+};
 function parseArgs() {
     const args = process.argv.slice(2);
     const config = {
@@ -27,40 +37,36 @@ function parseArgs() {
         multiUser: false,
         login: false,
         logout: false,
-        verifyLogin: false
+        verifyLogin: false,
+        serverUrl: process.env.SERVER_URL || 'http://localhost:55000'
     };
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === '--setup-auth') {
+        if (arg === '--setup-auth')
             config.setupAuth = true;
-        }
-        else if (arg === '--reset-auth') {
+        else if (arg === '--reset-auth')
             config.resetAuth = true;
-        }
-        else if (arg === '--debug' || arg === '-d') {
+        else if (arg === '--debug')
             config.debug = true;
-        }
-        else if (arg === '--non-interactive' || arg === '-n') {
+        else if (arg === '--non-interactive' || arg === '-n')
             config.nonInteractive = true;
-        }
-        else if (arg === '--multi-user') {
+        else if (arg === '--multi-user')
             config.multiUser = true;
-        }
-        else if (arg === '--login') {
+        else if (arg === '--login')
             config.login = true;
-        }
-        else if (arg === '--logout') {
+        else if (arg === '--logout')
             config.logout = true;
-        }
-        else if (arg === '--verify-login') {
+        else if (arg === '--verify-login')
             config.verifyLogin = true;
+        else if (arg === '--server-url' && i + 1 < args.length) {
+            config.serverUrl = args[++i];
         }
     }
     return config;
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.1.5"
+    version: "1.1.7"
 }, {
     capabilities: {
         resources: {
@@ -1052,7 +1058,7 @@ function getListOfArtifacts(functionName, attachments) {
 // Set up Express server for file serving
 const app = express();
 const PORT = process.env.PORT || 55000;
-const SERVER_URL = process.env.SERVER_URL || `http://localhost:${PORT}`;
+const SERVER_URL = ms365Config.serverUrl || `http://localhost:${PORT}`;
 // Get the directory name in ESM
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);

package/dist/utils/ms365-operations.js

@@ -1,4 +1,5 @@
 import { logger } from './api.js';
+import mimeTypes from 'mime-types';
 /**
  * Microsoft 365 operations manager class
  */
@@ -686,19 +687,48 @@ export class MS365Operations {
     async getAttachment(messageId, attachmentId) {
         try {
             const graphClient = await this.getGraphClient();
+            logger.log(`Fetching attachment ${attachmentId} from message ${messageId}...`);
+            // First get attachment metadata
             const attachment = await graphClient
                 .api(`/me/messages/${messageId}/attachments/${attachmentId}`)
                 .get();
-            return {
-                name: attachment.name || '',
-                contentType: attachment.contentType || 'application/octet-stream',
-                contentBytes: attachment.contentBytes || '',
+            logger.log(`Retrieved attachment metadata: ${attachment.name} (${attachment.contentType}, ${attachment.size} bytes)`);
+            // Determine content type if not provided
+            let contentType = attachment.contentType;
+            if (!contentType && attachment.name) {
+                contentType = mimeTypes.lookup(attachment.name) || 'application/octet-stream';
+                logger.log(`Inferred content type for ${attachment.name}: ${contentType}`);
+            }
+            // Validate content bytes
+            if (!attachment.contentBytes) {
+                logger.error('No content bytes found in attachment');
+                throw new Error('Attachment content is empty');
+            }
+            // Return the attachment data
+            const result = {
+                name: attachment.name || 'unnamed_attachment',
+                contentType: contentType || 'application/octet-stream',
+                contentBytes: attachment.contentBytes,
                 size: attachment.size || 0
             };
+            logger.log(`Successfully processed attachment: ${result.name} (${result.contentType}, ${result.size} bytes)`);
+            return result;
         }
         catch (error) {
             logger.error('Error getting attachment:', error);
-            throw error;
+            // Provide more specific error messages
+            if (error.status === 404) {
+                throw new Error(`Attachment not found: ${error.message}`);
+            }
+            else if (error.status === 401) {
+                throw new Error('Authentication failed. Please re-authenticate.');
+            }
+            else if (error.status === 403) {
+                throw new Error('Permission denied to access this attachment.');
+            }
+            else {
+                throw new Error(`Failed to get attachment: ${error.message}`);
+            }
         }
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms365-mcp-server",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Microsoft 365 MCP Server for managing Microsoft 365 email through natural language interactions with full OAuth2 authentication support",
   "main": "dist/index.js",
   "type": "module",