@mcptoolgate/client 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+# MCP Tool Gate Client
+
+Lightweight MCP client for integrating MCP Tool Gate with Claude Desktop and other MCP clients.
+
+## Installation
+
+### Quick Start (npx)
+
+```json
+{
+  "mcpServers": {
+    "mcptoolgate": {
+      "command": "npx",
+      "args": ["-y", "@mcptoolgate/client"],
+      "env": {
+        "MCPTOOLGATE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the client
+npm run build
+
+# Link for local testing
+npm link
+```
+
+## Configuration
+
+The client requires two environment variables:
+
+- **MCPTOOLGATE_API_KEY** (required): Your API key from the MCP Tool Gate dashboard
+- **MCPTOOLGATE_URL** (optional): Backend URL (defaults to production)
+
+## Usage with Claude Desktop
+
+1. **Generate API Key:**
+   - Log in to your MCP Tool Gate dashboard
+   - Go to Settings → API Keys
+   - Click "Generate New Key"
+   - Copy the key (shown only once!)
+
+2. **Configure Claude Desktop:**
+   
+   Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+   
+   ```json
+   {
+     "mcpServers": {
+       "mcptoolgate": {
+         "command": "npx",
+         "args": ["-y", "@mcptoolgate/client"],
+         "env": {
+           "MCPTOOLGATE_API_KEY": "mgk_your_key_here"
+         }
+       }
+     }
+   }
+   ```
+
+3. **Restart Claude Desktop**
+
+4. **Start using your tools!**
+   - Your configured tools will appear automatically
+   - Destructive actions will require approval
+   - Check your dashboard for approval requests
+
+## Features
+
+- ✅ **Zero Configuration**: Just add your API key
+- ✅ **Automatic Tool Discovery**: Tools from your dashboard appear instantly
+- ✅ **Policy Enforcement**: Backend applies all your configured policies
+- ✅ **Approval Workflows**: Destructive actions pause for human review
+- ✅ **Real-time**: No caching, always up-to-date
+
+## Troubleshooting
+
+### Tools not appearing?
+
+1. Check your API key is correct
+2. Verify the key isn't revoked in the dashboard
+3. Check Claude Desktop logs: `tail -f ~/Library/Logs/Claude/mcp*.log`
+
+### Execution failing?
+
+1. Check tool adapter configuration in dashboard
+2. Verify credentials (Slack webhooks, GitHub tokens, etc.)
+3. Check audit logs in dashboard for error details
+
+## Support
+
+- Dashboard: https://your-dashboard-url.com
+- Documentation: https://docs.mcptoolgate.com
+- Issues: https://github.com/your-org/mcp-tool-gate/issues
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,29 @@
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: any;
+}
+export interface ExecutionResult {
+    status: 'completed' | 'pending_approval' | 'denied' | 'failed';
+    result?: any;
+    approval_request_id?: string;
+    message?: string;
+    error?: string;
+}
+export declare class MCPToolGateAPI {
+    private client;
+    constructor(apiKey: string, baseURL: string);
+    /**
+     * List all available tools for the authenticated tenant
+     */
+    listTools(): Promise<Tool[]>;
+    /**
+     * Execute a tool with given input
+     */
+    executeTool(toolName: string, input: any): Promise<ExecutionResult>;
+    /**
+     * Check approval status for a pending request
+     */
+    checkApprovalStatus(requestId: string): Promise<any>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/D,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAW3C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAUlC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBzE;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAS7D"}

package/dist/api.js

@@ -0,0 +1,61 @@
+import axios from 'axios';
+export class MCPToolGateAPI {
+    client;
+    constructor(apiKey, baseURL) {
+        this.client = axios.create({
+            baseURL,
+            headers: {
+                'x-api-key': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000, // 30 second timeout
+        });
+    }
+    /**
+     * List all available tools for the authenticated tenant
+     */
+    async listTools() {
+        try {
+            const response = await this.client.get('/v1/mcp/tools');
+            return response.data.tools || [];
+        }
+        catch (error) {
+            console.error('[MCP Tool Gate API] Error listing tools:', error.message);
+            throw new Error(`Failed to list tools: ${error.response?.data?.error || error.message}`);
+        }
+    }
+    /**
+     * Execute a tool with given input
+     */
+    async executeTool(toolName, input) {
+        try {
+            const response = await this.client.post('/v1/mcp/execute', {
+                tool: toolName,
+                input,
+            });
+            return response.data;
+        }
+        catch (error) {
+            console.error('[MCP Tool Gate API] Error executing tool:', error.message);
+            // Return failed status instead of throwing
+            return {
+                status: 'failed',
+                error: error.response?.data?.error || error.message,
+            };
+        }
+    }
+    /**
+     * Check approval status for a pending request
+     */
+    async checkApprovalStatus(requestId) {
+        try {
+            const response = await this.client.get(`/v1/mcp/approvals/${requestId}`);
+            return response.data;
+        }
+        catch (error) {
+            console.error('[MCP Tool Gate API] Error checking approval:', error.message);
+            throw new Error(`Failed to check approval: ${error.response?.data?.error || error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAgB7C,MAAM,OAAO,cAAc;IACf,MAAM,CAAgB;IAE9B,YAAY,MAAc,EAAE,OAAe;QACvC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO;YACP,OAAO,EAAE;gBACL,WAAW,EAAE,MAAM;gBACnB,cAAc,EAAE,kBAAkB;aACrC;YACD,OAAO,EAAE,KAAK,EAAE,oBAAoB;SACvC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACX,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACxD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,KAAU;QAC1C,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBACvD,IAAI,EAAE,QAAQ;gBACd,KAAK;aACR,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAE1E,2CAA2C;YAC3C,OAAO;gBACH,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO;aACtD,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACvC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;YACzE,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;IACL,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { MCPToolGateAPI } from './api.js';
+// Get configuration from environment
+const API_KEY = process.env.MCPTOOLGATE_API_KEY;
+const API_URL = process.env.MCPTOOLGATE_URL || 'https://app.mcptoolgate.com';
+if (!API_KEY) {
+    console.error('Error: MCPTOOLGATE_API_KEY environment variable is required');
+    process.exit(1);
+}
+// Initialize API client
+const api = new MCPToolGateAPI(API_KEY, API_URL);
+// Create MCP server
+const server = new Server({
+    name: 'mcptoolgate',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool listing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    try {
+        const tools = await api.listTools();
+        return {
+            tools: tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    }
+    catch (error) {
+        console.error('Error listing tools:', error);
+        throw error;
+    }
+});
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        console.error(`[MCP Tool Gate] Executing tool: ${name}`);
+        const result = await api.executeTool(name, args || {});
+        // Handle different execution statuses
+        if (result.status === 'pending_approval') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `⏸️ Tool execution paused - approval required.\n\nApproval Request ID: ${result.approval_request_id}\n\nPlease check your MCP Tool Gate dashboard to approve or deny this request.`,
+                    },
+                ],
+            };
+        }
+        if (result.status === 'denied') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Tool execution denied by policy.\n\n${result.message || 'This action is not allowed.'}`,
+                    },
+                ],
+            };
+        }
+        if (result.status === 'failed') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Tool execution failed.\n\n${result.error || 'An error occurred during execution.'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Success
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: typeof result.result === 'string'
+                        ? result.result
+                        : JSON.stringify(result.result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        console.error('[MCP Tool Gate] Tool execution error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message || 'Tool execution failed'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[MCP Tool Gate] Client connected to', API_URL);
+}
+main().catch((error) => {
+    console.error('[MCP Tool Gate] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+    "name": "@mcptoolgate/client",
+    "version": "1.0.0",
+    "description": "MCP Tool Gate client for Claude Desktop - secure MCP tool governance",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "mcptoolgate-client": "dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "claude",
+        "security",
+        "governance",
+        "approval"
+    ],
+    "author": "MCP Tool Gate",
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^0.5.0",
+        "axios": "^1.6.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "typescript": "^5.3.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}

package/src/api.ts

@@ -0,0 +1,78 @@
+import axios, { AxiosInstance } from 'axios';
+
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: any;
+}
+
+export interface ExecutionResult {
+    status: 'completed' | 'pending_approval' | 'denied' | 'failed';
+    result?: any;
+    approval_request_id?: string;
+    message?: string;
+    error?: string;
+}
+
+export class MCPToolGateAPI {
+    private client: AxiosInstance;
+
+    constructor(apiKey: string, baseURL: string) {
+        this.client = axios.create({
+            baseURL,
+            headers: {
+                'x-api-key': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000, // 30 second timeout
+        });
+    }
+
+    /**
+     * List all available tools for the authenticated tenant
+     */
+    async listTools(): Promise<Tool[]> {
+        try {
+            const response = await this.client.get('/v1/mcp/tools');
+            return response.data.tools || [];
+        } catch (error: any) {
+            console.error('[MCP Tool Gate API] Error listing tools:', error.message);
+            throw new Error(`Failed to list tools: ${error.response?.data?.error || error.message}`);
+        }
+    }
+
+    /**
+     * Execute a tool with given input
+     */
+    async executeTool(toolName: string, input: any): Promise<ExecutionResult> {
+        try {
+            const response = await this.client.post('/v1/mcp/execute', {
+                tool: toolName,
+                input,
+            });
+
+            return response.data;
+        } catch (error: any) {
+            console.error('[MCP Tool Gate API] Error executing tool:', error.message);
+
+            // Return failed status instead of throwing
+            return {
+                status: 'failed',
+                error: error.response?.data?.error || error.message,
+            };
+        }
+    }
+
+    /**
+     * Check approval status for a pending request
+     */
+    async checkApprovalStatus(requestId: string): Promise<any> {
+        try {
+            const response = await this.client.get(`/v1/mcp/approvals/${requestId}`);
+            return response.data;
+        } catch (error: any) {
+            console.error('[MCP Tool Gate API] Error checking approval:', error.message);
+            throw new Error(`Failed to check approval: ${error.response?.data?.error || error.message}`);
+        }
+    }
+}

package/src/index.ts

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { MCPToolGateAPI } from './api.js';
+
+// Get configuration from environment
+const API_KEY = process.env.MCPTOOLGATE_API_KEY;
+const API_URL = process.env.MCPTOOLGATE_URL || 'https://app.mcptoolgate.com';
+
+if (!API_KEY) {
+    console.error('Error: MCPTOOLGATE_API_KEY environment variable is required');
+    process.exit(1);
+}
+
+// Initialize API client
+const api = new MCPToolGateAPI(API_KEY, API_URL);
+
+// Create MCP server
+const server = new Server(
+    {
+        name: 'mcptoolgate',
+        version: '1.0.0',
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
+    }
+);
+
+// Handle tool listing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    try {
+        const tools = await api.listTools();
+
+        return {
+            tools: tools.map((tool: any) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    } catch (error) {
+        console.error('Error listing tools:', error);
+        throw error;
+    }
+});
+
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+
+        console.error(`[MCP Tool Gate] Executing tool: ${name}`);
+
+        const result = await api.executeTool(name, args || {});
+
+        // Handle different execution statuses
+        if (result.status === 'pending_approval') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `⏸️ Tool execution paused - approval required.\n\nApproval Request ID: ${result.approval_request_id}\n\nPlease check your MCP Tool Gate dashboard to approve or deny this request.`,
+                    },
+                ],
+            };
+        }
+
+        if (result.status === 'denied') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Tool execution denied by policy.\n\n${result.message || 'This action is not allowed.'}`,
+                    },
+                ],
+            };
+        }
+
+        if (result.status === 'failed') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Tool execution failed.\n\n${result.error || 'An error occurred during execution.'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+
+        // Success
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: typeof result.result === 'string'
+                        ? result.result
+                        : JSON.stringify(result.result, null, 2),
+                },
+            ],
+        };
+    } catch (error: any) {
+        console.error('[MCP Tool Gate] Tool execution error:', error);
+
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message || 'Tool execution failed'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[MCP Tool Gate] Client connected to', API_URL);
+}
+
+main().catch((error) => {
+    console.error('[MCP Tool Gate] Fatal error:', error);
+    process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ES2022",
+        "moduleResolution": "node",
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}