@mcp-consultant-tools/teams 1.0.0

package/README.md

@@ -0,0 +1,134 @@
+# @mcp-consultant-tools/teams
+
+MCP server for Microsoft Teams integration. Send messages and adaptive cards to Teams channels for release announcements.
+
+## Features
+
+- Send text and markdown messages to Teams channels
+- Send Adaptive Cards with pre-built templates
+- Templates for release announcements, beta releases, and hotfixes
+- Client Credentials authentication (no user interaction required)
+- Token caching with automatic refresh
+
+## Installation
+
+```bash
+npm install @mcp-consultant-tools/teams
+```
+
+Or use directly with npx:
+
+```bash
+npx @mcp-consultant-tools/teams
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Required - Azure AD App Registration
+TEAMS_TENANT_ID=your-azure-tenant-id
+TEAMS_CLIENT_ID=your-app-client-id
+TEAMS_CLIENT_SECRET=your-client-secret
+
+# Optional - Default targets
+TEAMS_DEFAULT_TEAM_ID=team-guid
+TEAMS_DEFAULT_CHANNEL_ID=channel-guid
+```
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "teams": {
+      "command": "npx",
+      "args": ["-y", "@mcp-consultant-tools/teams@latest"],
+      "env": {
+        "TEAMS_TENANT_ID": "your-tenant-id",
+        "TEAMS_CLIENT_ID": "your-client-id",
+        "TEAMS_CLIENT_SECRET": "your-client-secret",
+        "TEAMS_DEFAULT_TEAM_ID": "optional-team-id",
+        "TEAMS_DEFAULT_CHANNEL_ID": "optional-channel-id"
+      }
+    }
+  }
+}
+```
+
+## Azure AD Setup
+
+### Required Permissions
+
+Create an Azure AD App Registration with these **Application permissions** (not Delegated):
+
+| Permission | Purpose |
+|------------|---------|
+| `ChannelMessage.Send` | Send messages to channels |
+| `Group.Read.All` | List teams and channels |
+| `Team.ReadBasic.All` | Read team information |
+
+**Important:** Admin consent is required for these permissions.
+
+### Setup Steps
+
+1. Go to [Azure Portal](https://portal.azure.com) → Azure Active Directory
+2. App registrations → New registration
+3. Name: "MCP Teams Release Bot"
+4. Supported account types: Single tenant
+5. API permissions → Add Application permissions (NOT delegated)
+6. Grant admin consent for your organization
+7. Certificates & secrets → Create new client secret
+8. Copy the secret value immediately
+
+## Tools
+
+### send-channel-message
+
+Send a text or markdown message to a Teams channel.
+
+```
+Message: "Hello from Claude!"
+Format: markdown
+Importance: normal
+```
+
+### send-adaptive-card
+
+Send an Adaptive Card using templates or raw JSON.
+
+**Available Templates:**
+- `release-announcement` - Standard release notification
+- `beta-release` - Beta release with warning styling
+- `hotfix` - Urgent hotfix notification
+
+Example with template:
+```json
+{
+  "template": "release-announcement",
+  "templateData": {
+    "packageName": "@mcp-consultant-tools/azure-devops",
+    "version": "27.0.0",
+    "summary": "New work item sync tools for efficient editing",
+    "date": "2025-01-16",
+    "releaseType": "Minor Release",
+    "changes": "- Added sync-work-item-to-file\n- Added sync-work-item-from-file",
+    "releaseNotesUrl": "https://github.com/..."
+  }
+}
+```
+
+### list-teams
+
+List Microsoft Teams the app has access to.
+
+### list-channels
+
+List channels in a team to find channel IDs for messaging.
+
+## License
+
+MIT

package/build/TeamsService.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Teams Service - Microsoft Graph API client for Teams operations
+ *
+ * Supports two authentication modes:
+ * - Client Credentials (app-only) - for automation, requires client secret
+ * - Device Code (user auth) - for interactive use, authenticates via browser
+ *
+ * For device-code mode, use the authenticate() method first, which returns
+ * the URL and code for the user to complete authentication.
+ */
+import type { TeamsConfig, AdaptiveCard, TeamInfo, ChannelInfo, SendMessageResult, MessageImportance, AuthStatusResponse, DeviceCodeResponse, AuthResult } from "./types.js";
+export declare class TeamsService {
+    private config;
+    private msalConfidentialClient;
+    private msalPublicClient;
+    private graphClient;
+    private accessToken;
+    private tokenExpirationTime;
+    private pendingAuth;
+    constructor(config: TeamsConfig);
+    /**
+     * Load stored token from disk (device-code mode)
+     */
+    private loadStoredToken;
+    /**
+     * Save token to disk (device-code mode)
+     */
+    private saveToken;
+    /**
+     * Get access token - handles both auth modes
+     */
+    private getAccessToken;
+    /**
+     * Get token using client credentials flow
+     */
+    private getTokenClientCredentials;
+    /**
+     * Get token using device code flow
+     * This method checks for existing/cached tokens or waits for pending auth.
+     * It does NOT start a new auth flow - use startAuthentication() for that.
+     */
+    private getTokenDeviceCode;
+    /**
+     * Check if authenticated (device-code mode)
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current authentication status
+     */
+    getAuthStatus(): AuthStatusResponse;
+    /**
+     * Start device-code authentication flow
+     * Returns immediately with the URL and code for the user
+     * Polls in background and resolves when complete
+     */
+    startAuthentication(): Promise<DeviceCodeResponse | AuthResult>;
+    /**
+     * Wait for pending authentication to complete
+     * @param timeoutMs Maximum time to wait (default 5 minutes)
+     */
+    waitForAuthentication(timeoutMs?: number): Promise<AuthResult>;
+    /**
+     * Require authentication before proceeding
+     * Throws a helpful error if not authenticated
+     */
+    requireAuth(): void;
+    /**
+     * Clear stored authentication (device-code mode)
+     */
+    logout(): void;
+    /**
+     * Get or create Graph client with current access token
+     */
+    private getGraphClient;
+    /**
+     * Get the effective team ID (from parameter or default)
+     */
+    private getTeamId;
+    /**
+     * Get the effective channel ID (from parameter or default)
+     */
+    private getChannelId;
+    /**
+     * List teams the user/app has access to
+     */
+    listTeams(): Promise<TeamInfo[]>;
+    /**
+     * List channels in a team
+     */
+    listChannels(teamId?: string): Promise<ChannelInfo[]>;
+    /**
+     * Send a text or HTML message to a channel
+     */
+    sendChannelMessage(content: string, options?: {
+        teamId?: string;
+        channelId?: string;
+        contentType?: "text" | "html";
+        importance?: MessageImportance;
+    }): Promise<SendMessageResult>;
+    /**
+     * Send an Adaptive Card to a channel
+     */
+    sendAdaptiveCard(card: AdaptiveCard, options?: {
+        teamId?: string;
+        channelId?: string;
+        importance?: MessageImportance;
+    }): Promise<SendMessageResult>;
+}
+export type { TeamsConfig };
+//# sourceMappingURL=TeamsService.d.ts.map

package/build/TeamsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeamsService.d.ts","sourceRoot":"","sources":["../src/TeamsService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EAEjB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACX,MAAM,YAAY,CAAC;AAoBpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,sBAAsB,CAA8C;IAC5E,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,EAAE,WAAW;IA8B/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB;;OAEG;YACW,cAAc;IAe5B;;OAEG;YACW,yBAAyB;IA2BvC;;;;OAIG;YACW,kBAAkB;IAiDhC;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,kBAAkB;IAgEnC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,GAAG,UAAU,CAAC;IAuHrE;;;OAGG;IACG,qBAAqB,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IA6C5E;;;OAGG;IACH,WAAW,IAAI,IAAI;IAsBnB;;OAEG;IACH,MAAM,IAAI,IAAI;IAed;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA0BtC;;OAEG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsB3D;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9B,UAAU,CAAC,EAAE,iBAAiB,CAAC;KAC3B,GACL,OAAO,CAAC,iBAAiB,CAAC;IA+B7B;;OAEG;IACG,gBAAgB,CACpB,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,iBAAiB,CAAC;KAC3B,GACL,OAAO,CAAC,iBAAiB,CAAC;CAqC9B;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}