@goforgeit/mcp-slack 0.4.11 → 0.4.19

package/dist/index.js

@@ -18,7 +18,9 @@ var ForgeOAuthTokensSchema = z.object({
   connectedAt: z.string(),
   scope: z.string().optional(),
   email: z.string().optional(),
-  accountId: z.string().optional()
+  accountId: z.string().optional(),
+  /** User-level access token (Slack xoxp-* token for search operations) */
+  userAccessToken: z.string().optional()
 });
 var DEFAULT_REFRESH_BUFFER_MS = 5 * 60 * 1e3;
 function createForgeTokenManager(options) {
@@ -100,6 +102,12 @@ function createForgeTokenManager(options) {
       }
       return cachedTokens.accessToken;
     },
+    async getUserAccessToken() {
+      if (!cachedTokens) {
+        await this.getAccessToken();
+      }
+      return cachedTokens?.userAccessToken ?? null;
+    },
     getTokenInfo() {
       return cachedTokens;
     },
@@ -131,6 +139,13 @@ function createSlackMCPServer(options) {
     const token = await tokenManager.getAccessToken();
     return new WebClient(token);
   }
+  async function getUserClient() {
+    const userToken = await tokenManager.getUserAccessToken();
+    if (userToken) {
+      return new WebClient(userToken);
+    }
+    return getClient();
+  }
   registerTool(
     "list_channels",
     "List Slack channels the bot has access to",
@@ -192,7 +207,7 @@ function createSlackMCPServer(options) {
       count: z2.number().optional().default(20).describe("Number of results")
     },
     async (args) => {
-      const client = await getClient();
+      const client = await getUserClient();
       const result = await client.search.messages({
         query: args.query,
         sort: args.sort || "score",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../../shared/src/mcp-auth/forge-token-manager.ts"],"sourcesContent":["/**\n * @goforgeit/mcp-slack — MCP server for Slack\n *\n * Provides channel, message, and user tools via stdio transport.\n * Reads Forge's OAuth tokens and uses Slack Web API.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { WebClient } from '@slack/web-api';\nimport { createForgeTokenManager } from '@forge/shared/mcp-auth';\n\nconst SLACK_TOKEN_URL = 'https://slack.com/api/oauth.v2.access';\n\nexport interface SlackMCPOptions {\n  tokenPath: string;\n  clientId: string;\n  clientSecret: string;\n}\n\ninterface ToolHandler {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;\n}\n\ninterface SlackMCPServer {\n  server: McpServer;\n  getRegisteredTools(): Record<string, ToolHandler>;\n  start(): Promise<void>;\n}\n\nexport function createSlackMCPServer(options: SlackMCPOptions): SlackMCPServer {\n  const tokenManager = createForgeTokenManager({\n    tokenPath: options.tokenPath,\n    clientId: options.clientId,\n    clientSecret: options.clientSecret,\n    tokenUrl: SLACK_TOKEN_URL,\n  });\n\n  const server = new McpServer({\n    name: '@goforgeit/mcp-slack',\n    version: '0.1.0',\n  });\n\n  const registeredTools: Record<string, ToolHandler> = {};\n\n  function registerTool(\n    name: string,\n    description: string,\n    schema: Record<string, z.ZodType>,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>,\n  ) {\n    registeredTools[name] = { handler };\n    server.tool(name, description, schema, handler);\n  }\n\n  async function getClient(): Promise<WebClient> {\n    const token = await tokenManager.getAccessToken();\n    return new WebClient(token);\n  }\n\n  // --- Channel Tools ---\n\n  registerTool(\n    'list_channels',\n    'List Slack channels the bot has access to',\n    {\n      types: z\n        .string()\n        .optional()\n        .default('public_channel')\n        .describe('Channel types (comma-separated: public_channel, private_channel, mpim, im)'),\n      limit: z.number().optional().default(100).describe('Maximum channels to return'),\n    },\n    async (args: { types?: string; limit?: number }) => {\n      const client = await getClient();\n      const result = await client.conversations.list({\n        types: args.types || 'public_channel',\n        limit: args.limit || 100,\n      });\n\n      const channels = (result.channels || []).map((ch) => ({\n        id: ch.id,\n        name: ch.name,\n        topic: ch.topic?.value,\n        num_members: ch.num_members,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ channels }) }],\n      };\n    },\n  );\n\n  registerTool(\n    'get_channel_history',\n    'Get message history from a Slack channel',\n    {\n      channelId: z.string().describe('Slack channel ID'),\n      limit: z.number().optional().default(20).describe('Number of messages to fetch'),\n      oldest: z.string().optional().describe('Start of time range (Unix timestamp)'),\n      latest: z.string().optional().describe('End of time range (Unix timestamp)'),\n    },\n    async (args: { channelId: string; limit?: number; oldest?: string; latest?: string }) => {\n      const client = await getClient();\n      const result = await client.conversations.history({\n        channel: args.channelId,\n        limit: args.limit || 20,\n        oldest: args.oldest,\n        latest: args.latest,\n      });\n\n      const messages = (result.messages || []).map((msg) => ({\n        ts: msg.ts,\n        text: msg.text,\n        user: msg.user,\n        type: msg.type,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ messages }) }],\n      };\n    },\n  );\n\n  // --- Message Tools ---\n\n  registerTool(\n    'search_messages',\n    'Search Slack messages across all channels',\n    {\n      query: z.string().describe('Search query'),\n      sort: z.enum(['score', 'timestamp']).optional().default('score').describe('Sort order'),\n      count: z.number().optional().default(20).describe('Number of results'),\n    },\n    async (args: { query: string; sort?: 'score' | 'timestamp'; count?: number }) => {\n      const client = await getClient();\n      const result = await client.search.messages({\n        query: args.query,\n        sort: args.sort || 'score',\n        count: args.count || 20,\n      });\n\n      const matches = result.messages?.matches || [];\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              matches: matches.map((m) => ({\n                ts: m.ts,\n                text: m.text,\n                channel: m.channel,\n                user: m.user,\n              })),\n              total: result.messages?.total || 0,\n            }),\n          },\n        ],\n      };\n    },\n  );\n\n  // --- User Tools ---\n\n  registerTool(\n    'list_users',\n    'List Slack workspace members',\n    {\n      limit: z.number().optional().default(100).describe('Maximum users to return'),\n    },\n    async (args: { limit?: number }) => {\n      const client = await getClient();\n      const result = await client.users.list({\n        limit: args.limit || 100,\n      });\n\n      const members = (result.members || []).map((m) => ({\n        id: m.id,\n        name: m.name,\n        real_name: m.real_name,\n        is_bot: m.is_bot,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ members }) }],\n      };\n    },\n  );\n\n  registerTool(\n    'get_user_info',\n    'Get detailed information about a Slack user',\n    {\n      userId: z.string().describe('Slack user ID'),\n    },\n    async (args: { userId: string }) => {\n      const client = await getClient();\n      const result = await client.users.info({\n        user: args.userId,\n      });\n\n      const user = result.user;\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              id: user?.id,\n              name: user?.name,\n              real_name: user?.real_name,\n              profile: user?.profile,\n              is_bot: user?.is_bot,\n              tz: user?.tz,\n            }),\n          },\n        ],\n      };\n    },\n  );\n\n  return {\n    server,\n    getRegisteredTools() {\n      return registeredTools;\n    },\n    async start() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n// CLI entry point\nconst isMainModule =\n  process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\\\/g, '/'));\nif (isMainModule || process.env.FORGE_MCP_START === 'true') {\n  const tokenPath = process.env.FORGE_TOKEN_PATH;\n  const clientId = process.env.FORGE_CLIENT_ID;\n  const clientSecret = process.env.FORGE_CLIENT_SECRET;\n\n  if (!tokenPath || !clientId || !clientSecret) {\n    console.error(\n      'Required environment variables: FORGE_TOKEN_PATH, FORGE_CLIENT_ID, FORGE_CLIENT_SECRET',\n    );\n    process.exit(1);\n  }\n\n  const mcpServer = createSlackMCPServer({ tokenPath, clientId, clientSecret });\n  mcpServer.start().catch((err) => {\n    console.error('Failed to start MCP server:', err);\n    process.exit(1);\n  });\n}\n","/**\n * Forge Token Manager — reads Forge's OAuthTokens format and handles refresh.\n *\n * Used by @forge/mcp-* packages to get valid access tokens for API calls.\n * Reads from FORGE_TOKEN_PATH, validates with Zod, and refreshes when\n * the token is expired or within 5 minutes of expiry.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { z } from 'zod';\n\n/** Zod schema for Forge's OAuth token file format */\nexport const ForgeOAuthTokensSchema = z.object({\n  accessToken: z.string(),\n  refreshToken: z.string().optional(),\n  expiresAt: z.number(),\n  providerId: z.string(),\n  connectedAt: z.string(),\n  scope: z.string().optional(),\n  email: z.string().optional(),\n  accountId: z.string().optional(),\n});\n\nexport type ForgeOAuthTokens = z.infer<typeof ForgeOAuthTokensSchema>;\n\nexport interface ForgeTokenManagerOptions {\n  /** Path to the Forge OAuth token JSON file */\n  tokenPath: string;\n  /** OAuth client ID for token refresh */\n  clientId: string;\n  /** OAuth client secret for token refresh */\n  clientSecret: string;\n  /** OAuth token endpoint URL for refresh requests */\n  tokenUrl: string;\n  /** Buffer in ms before expiry to trigger refresh (default: 5 minutes) */\n  refreshBufferMs?: number;\n}\n\nexport interface ForgeTokenManager {\n  /** Returns a valid access token, refreshing if needed */\n  getAccessToken(): Promise<string>;\n  /** Returns the current token data, or null if not yet loaded */\n  getTokenInfo(): ForgeOAuthTokens | null;\n  /** Register a callback for when tokens are refreshed */\n  onRefresh(callback: (tokens: ForgeOAuthTokens) => void): void;\n}\n\nconst DEFAULT_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes\n\nexport function createForgeTokenManager(options: ForgeTokenManagerOptions): ForgeTokenManager {\n  const {\n    tokenPath,\n    clientId,\n    clientSecret,\n    tokenUrl,\n    refreshBufferMs = DEFAULT_REFRESH_BUFFER_MS,\n  } = options;\n\n  let cachedTokens: ForgeOAuthTokens | null = null;\n  const refreshCallbacks: Array<(tokens: ForgeOAuthTokens) => void> = [];\n\n  function isExpiredOrNearExpiry(tokens: ForgeOAuthTokens): boolean {\n    return Date.now() >= tokens.expiresAt - refreshBufferMs;\n  }\n\n  async function readTokenFile(): Promise<ForgeOAuthTokens> {\n    let raw: string;\n    try {\n      raw = await fs.readFile(tokenPath, 'utf-8');\n    } catch (err: unknown) {\n      if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT') {\n        throw new Error(`Token file not found: ${tokenPath}`);\n      }\n      throw err;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      throw new Error(`Invalid JSON in token file: ${tokenPath}`);\n    }\n\n    const result = ForgeOAuthTokensSchema.safeParse(parsed);\n    if (!result.success) {\n      throw new Error(`Invalid token file format: ${result.error.message}`);\n    }\n\n    return result.data;\n  }\n\n  async function refreshToken(tokens: ForgeOAuthTokens): Promise<ForgeOAuthTokens> {\n    if (!tokens.refreshToken) {\n      throw new Error('No refresh token available — cannot refresh expired token');\n    }\n\n    const body = new URLSearchParams({\n      grant_type: 'refresh_token',\n      refresh_token: tokens.refreshToken,\n      client_id: clientId,\n      client_secret: clientSecret,\n    });\n\n    const response = await fetch(tokenUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n      body: body.toString(),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw new Error(`Token refresh failed (${response.status}): ${errorText}`);\n    }\n\n    const data = await response.json();\n\n    const refreshedTokens: ForgeOAuthTokens = {\n      ...tokens,\n      accessToken: data.access_token,\n      refreshToken: data.refresh_token || tokens.refreshToken,\n      expiresAt: Date.now() + data.expires_in * 1000,\n    };\n\n    // Write refreshed tokens back to file\n    await fs.mkdir(path.dirname(tokenPath), { recursive: true });\n    await fs.writeFile(tokenPath, JSON.stringify(refreshedTokens), { mode: 0o600 });\n\n    // Notify listeners\n    for (const cb of refreshCallbacks) {\n      cb(refreshedTokens);\n    }\n\n    return refreshedTokens;\n  }\n\n  return {\n    async getAccessToken(): Promise<string> {\n      if (cachedTokens && !isExpiredOrNearExpiry(cachedTokens)) {\n        return cachedTokens.accessToken;\n      }\n\n      const tokens = cachedTokens || (await readTokenFile());\n\n      if (isExpiredOrNearExpiry(tokens)) {\n        if (tokens.refreshToken) {\n          cachedTokens = await refreshToken(tokens);\n        } else {\n          // No refresh token — return the access token as-is.\n          // Some providers (e.g. Slack bot tokens) issue non-expiring tokens\n          // without refresh tokens, so the expiresAt may be unreliable.\n          cachedTokens = tokens;\n        }\n      } else {\n        cachedTokens = tokens;\n      }\n\n      return cachedTokens.accessToken;\n    },\n\n    getTokenInfo(): ForgeOAuthTokens | null {\n      return cachedTokens;\n    },\n\n    onRefresh(callback: (tokens: ForgeOAuthTokens) => void): void {\n      refreshCallbacks.push(callback);\n    },\n  };\n}\n\n/**\n * Create a ForgeTokenManager from standard environment variables.\n *\n * Expected env vars:\n * - FORGE_TOKEN_PATH: path to the OAuth token JSON file\n * - FORGE_CLIENT_ID: OAuth client ID\n * - FORGE_CLIENT_SECRET: OAuth client secret\n *\n * @param tokenUrl The provider's token endpoint URL\n */\nexport function createForgeTokenManagerFromEnv(tokenUrl: string): ForgeTokenManager {\n  const tokenPath = process.env.FORGE_TOKEN_PATH;\n  const clientId = process.env.FORGE_CLIENT_ID;\n  const clientSecret = process.env.FORGE_CLIENT_SECRET;\n\n  if (!tokenPath) throw new Error('FORGE_TOKEN_PATH environment variable is required');\n  if (!clientId) throw new Error('FORGE_CLIENT_ID environment variable is required');\n  if (!clientSecret) throw new Error('FORGE_CLIENT_SECRET environment variable is required');\n\n  return createForgeTokenManager({ tokenPath, clientId, clientSecret, tokenUrl });\n}\n"],"mappings":"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","names":["z","z"]}
+{"version":3,"sources":["../src/index.ts","../../shared/src/mcp-auth/forge-token-manager.ts"],"sourcesContent":["/**\n * @goforgeit/mcp-slack — MCP server for Slack\n *\n * Provides channel, message, and user tools via stdio transport.\n * Reads Forge's OAuth tokens and uses Slack Web API.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { WebClient } from '@slack/web-api';\nimport { createForgeTokenManager } from '@forge/shared/mcp-auth';\n\nconst SLACK_TOKEN_URL = 'https://slack.com/api/oauth.v2.access';\n\nexport interface SlackMCPOptions {\n  tokenPath: string;\n  clientId: string;\n  clientSecret: string;\n}\n\ninterface ToolHandler {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;\n}\n\ninterface SlackMCPServer {\n  server: McpServer;\n  getRegisteredTools(): Record<string, ToolHandler>;\n  start(): Promise<void>;\n}\n\nexport function createSlackMCPServer(options: SlackMCPOptions): SlackMCPServer {\n  const tokenManager = createForgeTokenManager({\n    tokenPath: options.tokenPath,\n    clientId: options.clientId,\n    clientSecret: options.clientSecret,\n    tokenUrl: SLACK_TOKEN_URL,\n  });\n\n  const server = new McpServer({\n    name: '@goforgeit/mcp-slack',\n    version: '0.1.0',\n  });\n\n  const registeredTools: Record<string, ToolHandler> = {};\n\n  function registerTool(\n    name: string,\n    description: string,\n    schema: Record<string, z.ZodType>,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>,\n  ) {\n    registeredTools[name] = { handler };\n    server.tool(name, description, schema, handler);\n  }\n\n  async function getClient(): Promise<WebClient> {\n    const token = await tokenManager.getAccessToken();\n    return new WebClient(token);\n  }\n\n  /** Get a client using the user token (needed for search operations) */\n  async function getUserClient(): Promise<WebClient> {\n    const userToken = await tokenManager.getUserAccessToken();\n    if (userToken) {\n      return new WebClient(userToken);\n    }\n    // Fall back to bot token (search will fail but other operations work)\n    return getClient();\n  }\n\n  // --- Channel Tools ---\n\n  registerTool(\n    'list_channels',\n    'List Slack channels the bot has access to',\n    {\n      types: z\n        .string()\n        .optional()\n        .default('public_channel')\n        .describe('Channel types (comma-separated: public_channel, private_channel, mpim, im)'),\n      limit: z.number().optional().default(100).describe('Maximum channels to return'),\n    },\n    async (args: { types?: string; limit?: number }) => {\n      const client = await getClient();\n      const result = await client.conversations.list({\n        types: args.types || 'public_channel',\n        limit: args.limit || 100,\n      });\n\n      const channels = (result.channels || []).map((ch) => ({\n        id: ch.id,\n        name: ch.name,\n        topic: ch.topic?.value,\n        num_members: ch.num_members,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ channels }) }],\n      };\n    },\n  );\n\n  registerTool(\n    'get_channel_history',\n    'Get message history from a Slack channel',\n    {\n      channelId: z.string().describe('Slack channel ID'),\n      limit: z.number().optional().default(20).describe('Number of messages to fetch'),\n      oldest: z.string().optional().describe('Start of time range (Unix timestamp)'),\n      latest: z.string().optional().describe('End of time range (Unix timestamp)'),\n    },\n    async (args: { channelId: string; limit?: number; oldest?: string; latest?: string }) => {\n      const client = await getClient();\n      const result = await client.conversations.history({\n        channel: args.channelId,\n        limit: args.limit || 20,\n        oldest: args.oldest,\n        latest: args.latest,\n      });\n\n      const messages = (result.messages || []).map((msg) => ({\n        ts: msg.ts,\n        text: msg.text,\n        user: msg.user,\n        type: msg.type,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ messages }) }],\n      };\n    },\n  );\n\n  // --- Message Tools ---\n\n  registerTool(\n    'search_messages',\n    'Search Slack messages across all channels',\n    {\n      query: z.string().describe('Search query'),\n      sort: z.enum(['score', 'timestamp']).optional().default('score').describe('Sort order'),\n      count: z.number().optional().default(20).describe('Number of results'),\n    },\n    async (args: { query: string; sort?: 'score' | 'timestamp'; count?: number }) => {\n      const client = await getUserClient();\n      const result = await client.search.messages({\n        query: args.query,\n        sort: args.sort || 'score',\n        count: args.count || 20,\n      });\n\n      const matches = result.messages?.matches || [];\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              matches: matches.map((m) => ({\n                ts: m.ts,\n                text: m.text,\n                channel: m.channel,\n                user: m.user,\n              })),\n              total: result.messages?.total || 0,\n            }),\n          },\n        ],\n      };\n    },\n  );\n\n  // --- User Tools ---\n\n  registerTool(\n    'list_users',\n    'List Slack workspace members',\n    {\n      limit: z.number().optional().default(100).describe('Maximum users to return'),\n    },\n    async (args: { limit?: number }) => {\n      const client = await getClient();\n      const result = await client.users.list({\n        limit: args.limit || 100,\n      });\n\n      const members = (result.members || []).map((m) => ({\n        id: m.id,\n        name: m.name,\n        real_name: m.real_name,\n        is_bot: m.is_bot,\n      }));\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify({ members }) }],\n      };\n    },\n  );\n\n  registerTool(\n    'get_user_info',\n    'Get detailed information about a Slack user',\n    {\n      userId: z.string().describe('Slack user ID'),\n    },\n    async (args: { userId: string }) => {\n      const client = await getClient();\n      const result = await client.users.info({\n        user: args.userId,\n      });\n\n      const user = result.user;\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              id: user?.id,\n              name: user?.name,\n              real_name: user?.real_name,\n              profile: user?.profile,\n              is_bot: user?.is_bot,\n              tz: user?.tz,\n            }),\n          },\n        ],\n      };\n    },\n  );\n\n  return {\n    server,\n    getRegisteredTools() {\n      return registeredTools;\n    },\n    async start() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n// CLI entry point\nconst isMainModule =\n  process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\\\/g, '/'));\nif (isMainModule || process.env.FORGE_MCP_START === 'true') {\n  const tokenPath = process.env.FORGE_TOKEN_PATH;\n  const clientId = process.env.FORGE_CLIENT_ID;\n  const clientSecret = process.env.FORGE_CLIENT_SECRET;\n\n  if (!tokenPath || !clientId || !clientSecret) {\n    console.error(\n      'Required environment variables: FORGE_TOKEN_PATH, FORGE_CLIENT_ID, FORGE_CLIENT_SECRET',\n    );\n    process.exit(1);\n  }\n\n  const mcpServer = createSlackMCPServer({ tokenPath, clientId, clientSecret });\n  mcpServer.start().catch((err) => {\n    console.error('Failed to start MCP server:', err);\n    process.exit(1);\n  });\n}\n","/**\n * Forge Token Manager — reads Forge's OAuthTokens format and handles refresh.\n *\n * Used by @goforgeit/mcp-* packages to get valid access tokens for API calls.\n * Reads from FORGE_TOKEN_PATH, validates with Zod, and refreshes when\n * the token is expired or within 5 minutes of expiry.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { z } from 'zod';\n\n/** Zod schema for Forge's OAuth token file format */\nexport const ForgeOAuthTokensSchema = z.object({\n  accessToken: z.string(),\n  refreshToken: z.string().optional(),\n  expiresAt: z.number(),\n  providerId: z.string(),\n  connectedAt: z.string(),\n  scope: z.string().optional(),\n  email: z.string().optional(),\n  accountId: z.string().optional(),\n  /** User-level access token (Slack xoxp-* token for search operations) */\n  userAccessToken: z.string().optional(),\n});\n\nexport type ForgeOAuthTokens = z.infer<typeof ForgeOAuthTokensSchema>;\n\nexport interface ForgeTokenManagerOptions {\n  /** Path to the Forge OAuth token JSON file */\n  tokenPath: string;\n  /** OAuth client ID for token refresh */\n  clientId: string;\n  /** OAuth client secret for token refresh */\n  clientSecret: string;\n  /** OAuth token endpoint URL for refresh requests */\n  tokenUrl: string;\n  /** Buffer in ms before expiry to trigger refresh (default: 5 minutes) */\n  refreshBufferMs?: number;\n}\n\nexport interface ForgeTokenManager {\n  /** Returns a valid access token, refreshing if needed */\n  getAccessToken(): Promise<string>;\n  /** Returns the user-level access token if available (e.g., Slack xoxp-* for search) */\n  getUserAccessToken(): Promise<string | null>;\n  /** Returns the current token data, or null if not yet loaded */\n  getTokenInfo(): ForgeOAuthTokens | null;\n  /** Register a callback for when tokens are refreshed */\n  onRefresh(callback: (tokens: ForgeOAuthTokens) => void): void;\n}\n\nconst DEFAULT_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes\n\nexport function createForgeTokenManager(options: ForgeTokenManagerOptions): ForgeTokenManager {\n  const {\n    tokenPath,\n    clientId,\n    clientSecret,\n    tokenUrl,\n    refreshBufferMs = DEFAULT_REFRESH_BUFFER_MS,\n  } = options;\n\n  let cachedTokens: ForgeOAuthTokens | null = null;\n  const refreshCallbacks: Array<(tokens: ForgeOAuthTokens) => void> = [];\n\n  function isExpiredOrNearExpiry(tokens: ForgeOAuthTokens): boolean {\n    return Date.now() >= tokens.expiresAt - refreshBufferMs;\n  }\n\n  async function readTokenFile(): Promise<ForgeOAuthTokens> {\n    let raw: string;\n    try {\n      raw = await fs.readFile(tokenPath, 'utf-8');\n    } catch (err: unknown) {\n      if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT') {\n        throw new Error(`Token file not found: ${tokenPath}`);\n      }\n      throw err;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      throw new Error(`Invalid JSON in token file: ${tokenPath}`);\n    }\n\n    const result = ForgeOAuthTokensSchema.safeParse(parsed);\n    if (!result.success) {\n      throw new Error(`Invalid token file format: ${result.error.message}`);\n    }\n\n    return result.data;\n  }\n\n  async function refreshToken(tokens: ForgeOAuthTokens): Promise<ForgeOAuthTokens> {\n    if (!tokens.refreshToken) {\n      throw new Error('No refresh token available — cannot refresh expired token');\n    }\n\n    const body = new URLSearchParams({\n      grant_type: 'refresh_token',\n      refresh_token: tokens.refreshToken,\n      client_id: clientId,\n      client_secret: clientSecret,\n    });\n\n    const response = await fetch(tokenUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n      body: body.toString(),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      throw new Error(`Token refresh failed (${response.status}): ${errorText}`);\n    }\n\n    const data = await response.json();\n\n    const refreshedTokens: ForgeOAuthTokens = {\n      ...tokens,\n      accessToken: data.access_token,\n      refreshToken: data.refresh_token || tokens.refreshToken,\n      expiresAt: Date.now() + data.expires_in * 1000,\n    };\n\n    // Write refreshed tokens back to file\n    await fs.mkdir(path.dirname(tokenPath), { recursive: true });\n    await fs.writeFile(tokenPath, JSON.stringify(refreshedTokens), { mode: 0o600 });\n\n    // Notify listeners\n    for (const cb of refreshCallbacks) {\n      cb(refreshedTokens);\n    }\n\n    return refreshedTokens;\n  }\n\n  return {\n    async getAccessToken(): Promise<string> {\n      if (cachedTokens && !isExpiredOrNearExpiry(cachedTokens)) {\n        return cachedTokens.accessToken;\n      }\n\n      const tokens = cachedTokens || (await readTokenFile());\n\n      if (isExpiredOrNearExpiry(tokens)) {\n        if (tokens.refreshToken) {\n          cachedTokens = await refreshToken(tokens);\n        } else {\n          // No refresh token — return the access token as-is.\n          // Some providers (e.g. Slack bot tokens) issue non-expiring tokens\n          // without refresh tokens, so the expiresAt may be unreliable.\n          cachedTokens = tokens;\n        }\n      } else {\n        cachedTokens = tokens;\n      }\n\n      return cachedTokens.accessToken;\n    },\n\n    async getUserAccessToken(): Promise<string | null> {\n      // Ensure tokens are loaded\n      if (!cachedTokens) {\n        await this.getAccessToken();\n      }\n      return cachedTokens?.userAccessToken ?? null;\n    },\n\n    getTokenInfo(): ForgeOAuthTokens | null {\n      return cachedTokens;\n    },\n\n    onRefresh(callback: (tokens: ForgeOAuthTokens) => void): void {\n      refreshCallbacks.push(callback);\n    },\n  };\n}\n\n/**\n * Create a ForgeTokenManager from standard environment variables.\n *\n * Expected env vars:\n * - FORGE_TOKEN_PATH: path to the OAuth token JSON file\n * - FORGE_CLIENT_ID: OAuth client ID\n * - FORGE_CLIENT_SECRET: OAuth client secret\n *\n * @param tokenUrl The provider's token endpoint URL\n */\nexport function createForgeTokenManagerFromEnv(tokenUrl: string): ForgeTokenManager {\n  const tokenPath = process.env.FORGE_TOKEN_PATH;\n  const clientId = process.env.FORGE_CLIENT_ID;\n  const clientSecret = process.env.FORGE_CLIENT_SECRET;\n\n  if (!tokenPath) throw new Error('FORGE_TOKEN_PATH environment variable is required');\n  if (!clientId) throw new Error('FORGE_CLIENT_ID environment variable is required');\n  if (!clientSecret) throw new Error('FORGE_CLIENT_SECRET environment variable is required');\n\n  return createForgeTokenManager({ tokenPath, clientId, clientSecret, tokenUrl });\n}\n"],"mappings":"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","names":["z","z"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goforgeit/mcp-slack",
-  "version": "0.4.11",
+  "version": "0.4.19",
   "type": "module",
   "description": "Forge MCP server for Slack (channels, messages, users)",
   "bin": {
@@ -8,25 +8,18 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
   },
   "dependencies": {
+    "@forge/shared": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@slack/web-api": "^7.0.0",
     "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@forge/shared": "workspace:*",
     "@types/node": "^22.10.2",
     "tsup": "^8.0.0",
     "vitest": "^3.2.4"

package/src/index.test.ts

@@ -0,0 +1,185 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createSlackMCPServer } from './index';
+
+vi.mock('@forge/shared/mcp-auth', () => ({
+  createForgeTokenManager: () => ({
+    getAccessToken: vi.fn().mockResolvedValue('xoxb-mock-token'),
+    getUserAccessToken: vi.fn().mockResolvedValue('xoxp-mock-user-token'),
+    getTokenInfo: () => null,
+    onRefresh: vi.fn(),
+  }),
+}));
+
+const mockConversationsList = vi.fn();
+const mockConversationsHistory = vi.fn();
+const mockSearchMessages = vi.fn();
+const mockUsersList = vi.fn();
+const mockUsersInfo = vi.fn();
+const mockChatPostMessage = vi.fn();
+
+vi.mock('@slack/web-api', () => ({
+  WebClient: vi.fn().mockImplementation(() => ({
+    conversations: {
+      list: mockConversationsList,
+      history: mockConversationsHistory,
+    },
+    search: {
+      messages: mockSearchMessages,
+    },
+    users: {
+      list: mockUsersList,
+      info: mockUsersInfo,
+    },
+    chat: {
+      postMessage: mockChatPostMessage,
+    },
+  })),
+}));
+
+describe('createSlackMCPServer', () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it('creates a server with registered tools', () => {
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    expect(server).toBeDefined();
+    const tools = server.getRegisteredTools();
+    expect(tools).toHaveProperty('list_channels');
+    expect(tools).toHaveProperty('get_channel_history');
+    expect(tools).toHaveProperty('search_messages');
+    expect(tools).toHaveProperty('list_users');
+    expect(tools).toHaveProperty('get_user_info');
+  });
+});
+
+describe('Slack Channel Tools', () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it('list_channels returns channels', async () => {
+    mockConversationsList.mockResolvedValue({
+      ok: true,
+      channels: [
+        { id: 'C001', name: 'general', topic: { value: 'General chat' }, num_members: 50 },
+        { id: 'C002', name: 'random', topic: { value: '' }, num_members: 45 },
+      ],
+    });
+
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    const tools = server.getRegisteredTools();
+    const result = await tools.list_channels.handler({ limit: 100 });
+    const parsed = JSON.parse(result.content[0].text);
+    expect(parsed.channels).toHaveLength(2);
+    expect(parsed.channels[0].name).toBe('general');
+  });
+
+  it('get_channel_history returns messages', async () => {
+    mockConversationsHistory.mockResolvedValue({
+      ok: true,
+      messages: [
+        { ts: '1234567890.123', text: 'Hello world', user: 'U001' },
+        { ts: '1234567891.456', text: 'Hi there', user: 'U002' },
+      ],
+    });
+
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    const tools = server.getRegisteredTools();
+    const result = await tools.get_channel_history.handler({
+      channelId: 'C001',
+      limit: 10,
+    });
+    const parsed = JSON.parse(result.content[0].text);
+    expect(parsed.messages).toHaveLength(2);
+  });
+});
+
+describe('Slack Message Tools', () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it('search_messages returns search results', async () => {
+    mockSearchMessages.mockResolvedValue({
+      ok: true,
+      messages: {
+        matches: [
+          {
+            ts: '123',
+            text: 'Found message',
+            channel: { id: 'C001', name: 'general' },
+            user: 'U001',
+          },
+        ],
+        total: 1,
+      },
+    });
+
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    const tools = server.getRegisteredTools();
+    const result = await tools.search_messages.handler({ query: 'test', count: 10 });
+    const parsed = JSON.parse(result.content[0].text);
+    expect(parsed.matches).toHaveLength(1);
+    expect(parsed.total).toBe(1);
+  });
+});
+
+describe('Slack User Tools', () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it('list_users returns user list', async () => {
+    mockUsersList.mockResolvedValue({
+      ok: true,
+      members: [
+        { id: 'U001', name: 'alice', real_name: 'Alice Smith', is_bot: false },
+        { id: 'U002', name: 'bob', real_name: 'Bob Jones', is_bot: false },
+      ],
+    });
+
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    const tools = server.getRegisteredTools();
+    const result = await tools.list_users.handler({ limit: 100 });
+    const parsed = JSON.parse(result.content[0].text);
+    expect(parsed.members).toHaveLength(2);
+  });
+
+  it('get_user_info returns user details', async () => {
+    mockUsersInfo.mockResolvedValue({
+      ok: true,
+      user: {
+        id: 'U001',
+        name: 'alice',
+        real_name: 'Alice Smith',
+        profile: { email: 'alice@example.com', title: 'Engineer' },
+        is_bot: false,
+        tz: 'America/Los_Angeles',
+      },
+    });
+
+    const server = createSlackMCPServer({
+      tokenPath: '/tmp/slack.json',
+      clientId: 'id',
+      clientSecret: 'secret',
+    });
+    const tools = server.getRegisteredTools();
+    const result = await tools.get_user_info.handler({ userId: 'U001' });
+    const parsed = JSON.parse(result.content[0].text);
+    expect(parsed.id).toBe('U001');
+    expect(parsed.real_name).toBe('Alice Smith');
+  });
+});

package/src/index.ts

@@ -0,0 +1,266 @@
+/**
+ * @goforgeit/mcp-slack — MCP server for Slack
+ *
+ * Provides channel, message, and user tools via stdio transport.
+ * Reads Forge's OAuth tokens and uses Slack Web API.
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { WebClient } from '@slack/web-api';
+import { createForgeTokenManager } from '@forge/shared/mcp-auth';
+
+const SLACK_TOKEN_URL = 'https://slack.com/api/oauth.v2.access';
+
+export interface SlackMCPOptions {
+  tokenPath: string;
+  clientId: string;
+  clientSecret: string;
+}
+
+interface ToolHandler {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;
+}
+
+interface SlackMCPServer {
+  server: McpServer;
+  getRegisteredTools(): Record<string, ToolHandler>;
+  start(): Promise<void>;
+}
+
+export function createSlackMCPServer(options: SlackMCPOptions): SlackMCPServer {
+  const tokenManager = createForgeTokenManager({
+    tokenPath: options.tokenPath,
+    clientId: options.clientId,
+    clientSecret: options.clientSecret,
+    tokenUrl: SLACK_TOKEN_URL,
+  });
+
+  const server = new McpServer({
+    name: '@goforgeit/mcp-slack',
+    version: '0.1.0',
+  });
+
+  const registeredTools: Record<string, ToolHandler> = {};
+
+  function registerTool(
+    name: string,
+    description: string,
+    schema: Record<string, z.ZodType>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    handler: (args: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>,
+  ) {
+    registeredTools[name] = { handler };
+    server.tool(name, description, schema, handler);
+  }
+
+  async function getClient(): Promise<WebClient> {
+    const token = await tokenManager.getAccessToken();
+    return new WebClient(token);
+  }
+
+  /** Get a client using the user token (needed for search operations) */
+  async function getUserClient(): Promise<WebClient> {
+    const userToken = await tokenManager.getUserAccessToken();
+    if (userToken) {
+      return new WebClient(userToken);
+    }
+    // Fall back to bot token (search will fail but other operations work)
+    return getClient();
+  }
+
+  // --- Channel Tools ---
+
+  registerTool(
+    'list_channels',
+    'List Slack channels the bot has access to',
+    {
+      types: z
+        .string()
+        .optional()
+        .default('public_channel')
+        .describe('Channel types (comma-separated: public_channel, private_channel, mpim, im)'),
+      limit: z.number().optional().default(100).describe('Maximum channels to return'),
+    },
+    async (args: { types?: string; limit?: number }) => {
+      const client = await getClient();
+      const result = await client.conversations.list({
+        types: args.types || 'public_channel',
+        limit: args.limit || 100,
+      });
+
+      const channels = (result.channels || []).map((ch) => ({
+        id: ch.id,
+        name: ch.name,
+        topic: ch.topic?.value,
+        num_members: ch.num_members,
+      }));
+
+      return {
+        content: [{ type: 'text' as const, text: JSON.stringify({ channels }) }],
+      };
+    },
+  );
+
+  registerTool(
+    'get_channel_history',
+    'Get message history from a Slack channel',
+    {
+      channelId: z.string().describe('Slack channel ID'),
+      limit: z.number().optional().default(20).describe('Number of messages to fetch'),
+      oldest: z.string().optional().describe('Start of time range (Unix timestamp)'),
+      latest: z.string().optional().describe('End of time range (Unix timestamp)'),
+    },
+    async (args: { channelId: string; limit?: number; oldest?: string; latest?: string }) => {
+      const client = await getClient();
+      const result = await client.conversations.history({
+        channel: args.channelId,
+        limit: args.limit || 20,
+        oldest: args.oldest,
+        latest: args.latest,
+      });
+
+      const messages = (result.messages || []).map((msg) => ({
+        ts: msg.ts,
+        text: msg.text,
+        user: msg.user,
+        type: msg.type,
+      }));
+
+      return {
+        content: [{ type: 'text' as const, text: JSON.stringify({ messages }) }],
+      };
+    },
+  );
+
+  // --- Message Tools ---
+
+  registerTool(
+    'search_messages',
+    'Search Slack messages across all channels',
+    {
+      query: z.string().describe('Search query'),
+      sort: z.enum(['score', 'timestamp']).optional().default('score').describe('Sort order'),
+      count: z.number().optional().default(20).describe('Number of results'),
+    },
+    async (args: { query: string; sort?: 'score' | 'timestamp'; count?: number }) => {
+      const client = await getUserClient();
+      const result = await client.search.messages({
+        query: args.query,
+        sort: args.sort || 'score',
+        count: args.count || 20,
+      });
+
+      const matches = result.messages?.matches || [];
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify({
+              matches: matches.map((m) => ({
+                ts: m.ts,
+                text: m.text,
+                channel: m.channel,
+                user: m.user,
+              })),
+              total: result.messages?.total || 0,
+            }),
+          },
+        ],
+      };
+    },
+  );
+
+  // --- User Tools ---
+
+  registerTool(
+    'list_users',
+    'List Slack workspace members',
+    {
+      limit: z.number().optional().default(100).describe('Maximum users to return'),
+    },
+    async (args: { limit?: number }) => {
+      const client = await getClient();
+      const result = await client.users.list({
+        limit: args.limit || 100,
+      });
+
+      const members = (result.members || []).map((m) => ({
+        id: m.id,
+        name: m.name,
+        real_name: m.real_name,
+        is_bot: m.is_bot,
+      }));
+
+      return {
+        content: [{ type: 'text' as const, text: JSON.stringify({ members }) }],
+      };
+    },
+  );
+
+  registerTool(
+    'get_user_info',
+    'Get detailed information about a Slack user',
+    {
+      userId: z.string().describe('Slack user ID'),
+    },
+    async (args: { userId: string }) => {
+      const client = await getClient();
+      const result = await client.users.info({
+        user: args.userId,
+      });
+
+      const user = result.user;
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify({
+              id: user?.id,
+              name: user?.name,
+              real_name: user?.real_name,
+              profile: user?.profile,
+              is_bot: user?.is_bot,
+              tz: user?.tz,
+            }),
+          },
+        ],
+      };
+    },
+  );
+
+  return {
+    server,
+    getRegisteredTools() {
+      return registeredTools;
+    },
+    async start() {
+      const transport = new StdioServerTransport();
+      await server.connect(transport);
+    },
+  };
+}
+
+// CLI entry point
+const isMainModule =
+  process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\/g, '/'));
+if (isMainModule || process.env.FORGE_MCP_START === 'true') {
+  const tokenPath = process.env.FORGE_TOKEN_PATH;
+  const clientId = process.env.FORGE_CLIENT_ID;
+  const clientSecret = process.env.FORGE_CLIENT_SECRET;
+
+  if (!tokenPath || !clientId || !clientSecret) {
+    console.error(
+      'Required environment variables: FORGE_TOKEN_PATH, FORGE_CLIENT_ID, FORGE_CLIENT_SECRET',
+    );
+    process.exit(1);
+  }
+
+  const mcpServer = createSlackMCPServer({ tokenPath, clientId, clientSecret });
+  mcpServer.start().catch((err) => {
+    console.error('Failed to start MCP server:', err);
+    process.exit(1);
+  });
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

package/tsup.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  target: 'node20',
+  outDir: 'dist',
+  clean: true,
+  dts: true,
+  sourcemap: true,
+  noExternal: ['@forge/shared'],
+  banner: {
+    js: '#!/usr/bin/env node',
+  },
+});