@agentiqus/slack-mcp-client 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @agentiqus/slack-mcp-client
+
+A thin stdio MCP server that connects AI tools (Cursor, Claude Desktop) to Slack through the [MCP Orchestrator](https://github.com/faruk-agentiqus/slack-mcp-orchestrator).
+
+## Usage
+
+This package is not used directly. The MCP Orchestrator Slack app generates a configuration JSON for you.
+
+1. Install the MCP Orchestrator app in your Slack workspace
+2. Open the app's Home tab, set your permissions, and click **Generate MCP Config**
+3. Paste the generated JSON into your AI tool's MCP config file
+
+### Cursor
+
+Paste into `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack": {
+      "command": "npx",
+      "args": ["-y", "@agentiqus/slack-mcp-client"],
+      "env": {
+        "MCP_TOKEN": "<your-token>",
+        "MCP_API_URL": "https://slack-mcp-orchestrator.fly.dev/api/mcp"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Paste into your Claude Desktop config file.
+
+## Environment Variables
+
+| Variable      | Description                                           |
+| ------------- | ----------------------------------------------------- |
+| `MCP_TOKEN`   | Per-user JWT issued by the MCP Orchestrator Slack app |
+| `MCP_API_URL` | Base URL of the MCP Orchestrator API                  |
+
+## How It Works
+
+This package runs as a local stdio process. It receives MCP tool calls from your AI tool, forwards them to the MCP Orchestrator API with your JWT, and returns the results. All permission enforcement happens server-side. Your Slack bot token never leaves the server.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * @agentiqus/slack-mcp-client
+ *
+ * A thin stdio MCP server that forwards all tool calls to the
+ * MCP Orchestrator HTTP API. It holds no business logic — just
+ * authentication forwarding and protocol bridging.
+ *
+ * Required env vars:
+ *   MCP_TOKEN   - Per-user JWT issued by the orchestrator
+ *   MCP_API_URL - Base URL of the orchestrator API (e.g. https://host/api/mcp)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * @agentiqus/slack-mcp-client
+ *
+ * A thin stdio MCP server that forwards all tool calls to the
+ * MCP Orchestrator HTTP API. It holds no business logic — just
+ * authentication forwarding and protocol bridging.
+ *
+ * Required env vars:
+ *   MCP_TOKEN   - Per-user JWT issued by the orchestrator
+ *   MCP_API_URL - Base URL of the orchestrator API (e.g. https://host/api/mcp)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const MCP_TOKEN = process.env.MCP_TOKEN;
+const MCP_API_URL = process.env.MCP_API_URL;
+if (!MCP_TOKEN) {
+    process.stderr.write('ERROR: MCP_TOKEN environment variable is required.\n');
+    process.exit(1);
+}
+if (!MCP_API_URL) {
+    process.stderr.write('ERROR: MCP_API_URL environment variable is required.\n');
+    process.exit(1);
+}
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+async function apiRequest(path, body) {
+    const url = `${MCP_API_URL}${path}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${MCP_TOKEN}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        let message;
+        try {
+            const json = JSON.parse(text);
+            message = json.error ?? text;
+        }
+        catch {
+            message = text;
+        }
+        if (response.status === 401) {
+            throw new Error(`Authentication failed: ${message}. Regenerate your MCP config in Slack.`);
+        }
+        if (response.status === 403) {
+            throw new Error(`Permission denied: ${message}`);
+        }
+        throw new Error(`API error (${response.status}): ${message}`);
+    }
+    return response.json();
+}
+// ---------------------------------------------------------------------------
+// MCP Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: '@agentiqus/slack-mcp-client', version: '0.1.0' }, { capabilities: { tools: {} } });
+// --- tools/list ---------------------------------------------------------------
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const result = (await apiRequest('/tools/list', {}));
+    return { tools: result.tools };
+});
+// --- tools/call ---------------------------------------------------------------
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const result = (await apiRequest('/tools/call', {
+            name: request.params.name,
+            arguments: request.params.arguments ?? {},
+        }));
+        return { content: result.content };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('Slack MCP client connected via stdio.\n');
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal: ${err}\n`);
+    process.exit(1);
+});

package/index.ts

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+/**
+ * @agentiqus/slack-mcp-client
+ *
+ * A thin stdio MCP server that forwards all tool calls to the
+ * MCP Orchestrator HTTP API. It holds no business logic — just
+ * authentication forwarding and protocol bridging.
+ *
+ * Required env vars:
+ *   MCP_TOKEN   - Per-user JWT issued by the orchestrator
+ *   MCP_API_URL - Base URL of the orchestrator API (e.g. https://host/api/mcp)
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+const MCP_TOKEN = process.env.MCP_TOKEN;
+const MCP_API_URL = process.env.MCP_API_URL;
+
+if (!MCP_TOKEN) {
+  process.stderr.write('ERROR: MCP_TOKEN environment variable is required.\n');
+  process.exit(1);
+}
+if (!MCP_API_URL) {
+  process.stderr.write(
+    'ERROR: MCP_API_URL environment variable is required.\n'
+  );
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+
+async function apiRequest(
+  path: string,
+  body: Record<string, unknown>
+): Promise<unknown> {
+  const url = `${MCP_API_URL}${path}`;
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${MCP_TOKEN}`,
+    },
+    body: JSON.stringify(body),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    let message: string;
+    try {
+      const json = JSON.parse(text);
+      message = json.error ?? text;
+    } catch {
+      message = text;
+    }
+
+    if (response.status === 401) {
+      throw new Error(
+        `Authentication failed: ${message}. Regenerate your MCP config in Slack.`
+      );
+    }
+    if (response.status === 403) {
+      throw new Error(`Permission denied: ${message}`);
+    }
+    throw new Error(`API error (${response.status}): ${message}`);
+  }
+
+  return response.json();
+}
+
+// ---------------------------------------------------------------------------
+// MCP Server
+// ---------------------------------------------------------------------------
+
+const server = new Server(
+  { name: '@agentiqus/slack-mcp-client', version: '0.1.0' },
+  { capabilities: { tools: {} } }
+);
+
+// --- tools/list ---------------------------------------------------------------
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  const result = (await apiRequest('/tools/list', {})) as {
+    tools: Array<{
+      name: string;
+      description: string;
+      inputSchema: Record<string, unknown>;
+    }>;
+  };
+  return { tools: result.tools };
+});
+
+// --- tools/call ---------------------------------------------------------------
+
+server.setRequestHandler(CallToolRequestSchema, async request => {
+  try {
+    const result = (await apiRequest('/tools/call', {
+      name: request.params.name,
+      arguments: request.params.arguments ?? {},
+    })) as { content: Array<{ type: string; text: string }> };
+
+    return { content: result.content };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Unknown error';
+    return {
+      content: [{ type: 'text', text: `Error: ${message}` }],
+      isError: true,
+    };
+  }
+});
+
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+
+async function main(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  process.stderr.write('Slack MCP client connected via stdio.\n');
+}
+
+main().catch(err => {
+  process.stderr.write(`Fatal: ${err}\n`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@agentiqus/slack-mcp-client",
+  "version": "0.1.0",
+  "description": "Thin stdio MCP server that proxies Slack operations through the MCP Orchestrator API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "slack-mcp-client": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "slack",
+    "model-context-protocol",
+    "ai-tools",
+    "cursor",
+    "claude"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/faruk-agentiqus/slack-mcp-orchestrator.git",
+    "directory": "packages/slack-mcp-client"
+  },
+  "homepage": "https://github.com/faruk-agentiqus/slack-mcp-orchestrator#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "nodenext",
+    "outDir": "./dist",
+    "strict": true,
+    "declaration": true
+  },
+  "include": [
+    "index.ts"
+  ]
+}