@softeria/ms-365-mcp-server 0.1.9 → 0.1.11

package/.github/workflows/build.yml

@@ -0,0 +1,31 @@
+name: Build
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [ 18.x, 20.x ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

package/.github/workflows/npm-publish.yml

@@ -1,6 +1,3 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
 name: Node.js Package
 
 on:

package/README.md

@@ -4,51 +4,157 @@ Microsoft 365 MCP Server
 
 A Model Context Protocol (MCP) server for interacting with Microsoft 365 services through the Graph API.
 
-[![Test Status](https://img.shields.io/badge/tests-passing-brightgreen)]()
+[![Build Status](https://github.com/softeria-eu/ms-365-mcp-server/actions/workflows/build.yml/badge.svg)](https://github.com/softeria-eu/ms-365-mcp-server/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/@softeria/ms-365-mcp-server.svg)](https://www.npmjs.com/package/@softeria/ms-365-mcp-server)
 
 ## Features
 
 - Authentication using Microsoft Authentication Library (MSAL)
 - Excel file operations:
-  - Update cell values
-  - Create and manage charts
-  - Format cells
-  - Sort data
-  - Create tables
-  - Read cell values
-  - List worksheets
+    - Update cell values
+    - Create and manage charts
+    - Format cells
+    - Sort data
+    - Create tables
+    - Read cell values
+    - List worksheets
 - Built on the Model Context Protocol
 
 ## Installation
 
 ```bash
-npm install -g ms-365-mcp-server
+npx @softeria/ms-365-mcp-server
 ```
 
-Or use directly with npx:
+## Integration with Claude
+
+### Claude Code CLI
+
+To add this MCP server to Claude Code CLI:
+
+```bash
+claude mcp add ms -- npx @softeria/ms-365-mcp-server
+```
+
+### Claude Desktop
+
+To add this MCP server to Claude Desktop:
+
+1. Launch Claude Desktop
+2. Go to Settings > MCPs
+3. Click "Add MCP"
+4. Set the following configuration:
+    - Name: `ms` (or any name you prefer)
+    - Command: `npx @softeria/ms-365-mcp-server`
+    - Click "Add"
+
+### Direct Configuration
+
+You can also use this configuration JSON in compatible Claude interfaces:
+
+```json
+{
+  "name": "ms",
+  "command": "npx @softeria/ms-365-mcp-server"
+}
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/softeria-eu/ms-365-mcp-server.git
+cd ms-365-mcp-server
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+```
+
+### GitHub Actions
+
+This repository uses GitHub Actions for continuous integration and deployment:
+
+- **Build Workflow**: Runs on all pushes to main and pull requests. Verifies the project builds successfully and passes
+  all tests.
+- **Publish Workflow**: Automatically publishes to npm when a new GitHub release is created.
+
+### Release Process
+
+To create a new release:
 
 ```bash
-npx ms-365-mcp-server
+npm run release
 ```
 
+This script will:
+
+1. Run tests to verify everything works
+2. Bump the version number
+3. Commit the version changes
+4. Push to GitHub
+5. Create a GitHub release
+6. Trigger the publish workflow to publish to npm
+
 ## Usage
 
 ### Command Line Options
 
 ```bash
-npx ms-365-mcp-server [options]
+npx @softeria/ms-365-mcp-server [options]
 ```
 
 Options:
 
-- `--login`: Force login using device code flow
+- `--login`: Force login using device code flow and verify Graph API access
 - `--logout`: Log out and clear saved credentials
-- `--file <path>`: Excel file path to use (default: "/Livet.xlsx")
-- `--silent`: Run without informational messages to stderr
+- `--test-login`: Test current authentication and verify Graph API access without starting the server
+- `-v`: Enable verbose logging
 
 ### Authentication
 
-The first time you run the server, it will automatically initiate the device code flow authentication. You'll see instructions in the terminal about how to complete the authentication in your browser.
+**Important:** You must authenticate before using the MCP server. There are two ways to authenticate:
+
+1. Running the server with the `--login` flag:
+   ```bash
+   npx @softeria/ms-365-mcp-server --login
+   ```
+   This will display the login URL and code in the terminal.
+
+2. When using Claude Code or other MCP clients, use the login tools:
+    - First use the `login` tool, which will return the login URL and code
+    - Visit the URL and enter the code in your browser
+    - Then use the `verify-login` tool to check if the login was successful
+
+Both methods trigger the device code flow authentication, but they handle the UI interaction differently:
+
+- CLI version displays the instructions directly in the terminal
+- MCP tool version returns the instructions as data that can be shown in the client UI
+
+You can verify your authentication status with the `--test-login` flag, which will check if your token can successfully
+fetch user data from Microsoft Graph API:
+
+```bash
+npx @softeria/ms-365-mcp-server --test-login
+```
+
+Both `--login` and `--test-login` will return a JSON response that includes your basic user information from Microsoft
+Graph API if authentication is successful:
+
+```json
+{
+  "success": true,
+  "message": "Login successful",
+  "userData": {
+    "displayName": "Your Name",
+    "userPrincipalName": "your.email@example.com"
+  }
+}
+```
 
 Authentication tokens are cached securely in your system's credential store with fallback to file storage if needed.
 
@@ -56,8 +162,10 @@ Authentication tokens are cached securely in your system's credential store with
 
 This server provides several MCP tools for interacting with Excel files:
 
-- `login`: Force a new login with Microsoft
+- `login`: Start a new login process with Microsoft (returns login URL and code)
+- `verify-login`: Check if login was completed successfully and verify Graph API access
 - `logout`: Log out of Microsoft and clear credentials
+- `test-login`: Test current authentication status and verify Graph API access
 - `update-excel`: Update cell values in an Excel worksheet
 - `create-chart`: Create a chart in an Excel worksheet
 - `format-range`: Apply formatting to a range of cells

package/auth.mjs

@@ -101,18 +101,24 @@ class AuthManager {
     throw new Error('No valid token found');
   }
 
-  async acquireTokenByDeviceCode() {
+  async acquireTokenByDeviceCode(hack) {
     const deviceCodeRequest = {
       scopes: this.scopes,
       deviceCodeCallback: (response) => {
-        // We need to show this message to the user in console
-        console.log('\n' + response.message + '\n');
+        const text = ['\n', response.message, '\n'].join('');
+        if (hack) {
+          hack(text + 'After login run the "test login" command');
+        } else {
+          console.log(text);
+        }
         logger.info('Device code login initiated');
       },
     };
 
     try {
+      logger.info('Requesting device code...');
       const response = await this.msalApp.acquireTokenByDeviceCode(deviceCodeRequest);
+      logger.info('Device code login successful');
       this.accessToken = response.accessToken;
       this.tokenExpiry = new Date(response.expiresOn).getTime();
       await this.saveTokenCache();
@@ -123,6 +129,63 @@ class AuthManager {
     }
   }
 
+  async testLogin() {
+    try {
+      logger.info('Testing login...');
+      const token = await this.getToken();
+
+      if (!token) {
+        logger.error('Login test failed - no token received');
+        return {
+          success: false,
+          message: 'Login failed - no token received',
+        };
+      }
+
+      logger.info('Token retrieved successfully, testing Graph API access...');
+
+      try {
+        const response = await fetch('https://graph.microsoft.com/v1.0/me', {
+          headers: {
+            Authorization: `Bearer ${token}`,
+          },
+        });
+
+        if (response.ok) {
+          const userData = await response.json();
+          logger.info('Graph API user data fetch successful');
+          return {
+            success: true,
+            message: 'Login successful',
+            userData: {
+              displayName: userData.displayName,
+              userPrincipalName: userData.userPrincipalName,
+            },
+          };
+        } else {
+          const errorText = await response.text();
+          logger.error(`Graph API user data fetch failed: ${response.status} - ${errorText}`);
+          return {
+            success: false,
+            message: `Login successful but Graph API access failed: ${response.status}`,
+          };
+        }
+      } catch (graphError) {
+        logger.error(`Error fetching user data: ${graphError.message}`);
+        return {
+          success: false,
+          message: `Login successful but Graph API access failed: ${graphError.message}`,
+        };
+      }
+    } catch (error) {
+      logger.error(`Login test failed: ${error.message}`);
+      return {
+        success: false,
+        message: `Login failed: ${error.message}`,
+      };
+    }
+  }
+
   async logout() {
     try {
       const accounts = await this.msalApp.getTokenCache().getAllAccounts();

package/bin/release.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import fs from 'fs';
+
+console.log('Running tests...');
+try {
+  execSync('npm test', { stdio: 'inherit' });
+} catch (error) {
+  console.error('Tests failed! Aborting release.');
+  process.exit(1);
+}
+
+console.log('Bumping version...');
+execSync('npm version --no-git-tag-version patch');
+
+const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+const version = packageJson.version;
+
+console.log('Committing version change...');
+execSync('git add package.json package-lock.json');
+execSync(`git commit -m "Bump version to ${version}"`);
+
+console.log('Pushing to remote...');
+execSync('git push');
+
+console.log(`Creating GitHub release for v${version}...`);
+execSync(`gh release create v${version} --title 'v${version}' --notes 'Version ${version}'`, {
+  stdio: 'inherit',
+});
+
+console.log(`Release v${version} created successfully!`);
+// GitHub Actions workflow will handle the npm publish automatically

package/index.mjs

@@ -161,12 +161,14 @@ const server = new McpServer({
 
 server.tool('login', {}, async () => {
   try {
-    await authManager.getToken(true);
+    const text = await new Promise((r) => {
+      authManager.acquireTokenByDeviceCode(r);
+    });
     return {
       content: [
         {
           type: 'text',
-          text: JSON.stringify({ message: 'Authentication successful' }),
+          text,
         },
       ],
     };
@@ -175,7 +177,7 @@ server.tool('login', {}, async () => {
       content: [
         {
           type: 'text',
-          text: JSON.stringify({ error: 'Authentication failed' }),
+          text: JSON.stringify({ error: `Authentication failed: ${error.message}` }),
         },
       ],
     };
@@ -205,6 +207,32 @@ server.tool('logout', {}, async () => {
   }
 });
 
+server.tool('test-login', {}, async () => {
+  const result = await authManager.testLogin();
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(result),
+      },
+    ],
+  };
+});
+
+server.tool('verify-login', {}, async () => {
+  // Test the login after the user has completed the device code authentication
+  const testResult = await authManager.testLogin();
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(testResult),
+      },
+    ],
+  };
+});
+
 server.tool(
   'update-excel',
   {
@@ -480,28 +508,15 @@ async function main() {
 
     if (args.login) {
       await authManager.acquireTokenByDeviceCode();
-      logger.info('Login completed, proceeding with session creation');
-      process.exit();
+      logger.info('Login completed, testing connection with Graph API...');
+      const result = await authManager.testLogin();
+      console.log(JSON.stringify(result));
+      process.exit(0);
     }
 
     if (args.testLogin) {
-      try {
-        logger.info('Testing login...');
-        const token = await authManager.getToken();
-        if (token) {
-          logger.info('Login test successful');
-
-          console.log(JSON.stringify({ success: true, message: 'Login successful' }));
-        } else {
-          logger.error('Login test failed - no token received');
-          console.log(
-            JSON.stringify({ success: false, message: 'Login failed - no token received' })
-          );
-        }
-      } catch (error) {
-        logger.error(`Login test failed: ${error.message}`);
-        console.log(JSON.stringify({ success: false, message: `Login failed: ${error.message}` }));
-      }
+      const result = await authManager.testLogin();
+      console.log(JSON.stringify(result));
       process.exit(0);
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Microsoft 365 MCP Server",
   "type": "module",
   "main": "index.mjs",