@closedloop-ai/mcp-client 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# ClosedLoop MCP Server
+
+A lightweight Model Context Protocol (MCP) server that provides AI clients with access to ClosedLoop customer feedback data.
+
+## Features
+
+- **MCP Protocol Support**: Full MCP protocol implementation for AI client integration
+- **API Key Authentication**: Secure team-based API key authentication
+- **Team Isolation**: All data access is scoped to the team that owns the API key
+- **Two Core Tools**:
+  - `list_insights`: Get customer insights with date range and pagination
+  - `get_insight_detail`: Get detailed information about specific insights
+
+## Installation
+
+```bash
+npm install -g @jirikobelka/server-closedloop
+```
+
+## Configuration
+
+Set the following environment variables:
+
+- `CLOSEDLOOP_API_KEY`: Your ClosedLoop API key (required)
+- `CLOSEDLOOP_SERVER_URL`: Server URL (default: https://mcp.closedloop.sh)
+
+## Usage with Claude
+
+Add this configuration to your Claude Desktop app:
+
+```json
+{
+  "mcpServers": {
+    "closedloop": {
+      "command": "npx",
+      "args": ["@jirikobelka/server-closedloop"],
+      "env": {
+        "CLOSEDLOOP_API_KEY": "your-api-key-here",
+        "CLOSEDLOOP_SERVER_URL": "https://mcp.closedloop.sh"
+      }
+    }
+  }
+}
+```
+
+## MCP Tools
+
+### list_insights
+Retrieve customer insights with optional filtering and pagination.
+
+**Parameters:**
+- `date_from` (optional): Start date (YYYY-MM-DD)
+- `date_to` (optional): End date (YYYY-MM-DD)  
+- `page` (optional): Page number (default: 1)
+- `limit` (optional): Items per page (default: 20, max: 100)
+
+### get_insight_detail
+Get detailed information about a specific insight item.
+
+**Parameters:**
+- `insight_id` (required): UUID of the insight item
+
+## Example Usage
+
+Once configured, you can ask Claude questions like:
+
+- "Show me all negative insights from last week"
+- "What are the top customer insights this month?"
+- "Find insights about the dashboard being confusing"
+- "Give me insights on user onboarding issues"
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const { CallToolRequestSchema, ListToolsRequestSchema } = require('@modelcontextprotocol/sdk/types.js');
+const axios = require('axios');
+
+// Get configuration from environment
+const CLOSEDLOOP_API_KEY = process.env.CLOSEDLOOP_API_KEY;
+const CLOSEDLOOP_SERVER_URL = process.env.CLOSEDLOOP_SERVER_URL || 'https://mcp.closedloop.sh';
+
+if (!CLOSEDLOOP_API_KEY) {
+  console.error('Error: CLOSEDLOOP_API_KEY environment variable is required');
+  process.exit(1);
+}
+
+// Create MCP server
+const server = new Server(
+  {
+    name: 'closedloop-mcp-server',
+    version: '1.0.0',
+    description: 'Provides access to ClosedLoop AI product feedback data and insights.',
+  },
+  {
+    capabilities: {
+      tools: {}
+    }
+  }
+);
+
+// Define available tools
+const tools = [
+  {
+    name: 'list_insights',
+    description: 'Retrieve customer insights with optional filtering and pagination',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        date_from: {
+          type: 'string',
+          description: 'Start date for insights (YYYY-MM-DD)',
+          format: 'date'
+        },
+        date_to: {
+          type: 'string', 
+          description: 'End date for insights (YYYY-MM-DD)',
+          format: 'date'
+        },
+        page: {
+          type: 'integer',
+          description: 'Page number (default: 1)',
+          minimum: 1
+        },
+        limit: {
+          type: 'integer',
+          description: 'Insight items per page (default: 20, max: 100)',
+          minimum: 1,
+          maximum: 100
+        }
+      }
+    }
+  },
+  {
+    name: 'get_insight_detail',
+    description: 'Get detailed information about a specific insight item',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        insight_id: {
+          type: 'string',
+          description: 'UUID of the insight item'
+        }
+      },
+      required: ['insight_id']
+    }
+  }
+];
+
+// List tools handler
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools };
+});
+
+// Call tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    const headers = {
+      'Authorization': `Bearer ${CLOSEDLOOP_API_KEY}`,
+      'Content-Type': 'application/json'
+    };
+
+    let response;
+
+    switch (name) {
+      case 'list_insights':
+        response = await axios.get(`${CLOSEDLOOP_SERVER_URL}/feedbacks`, {
+          headers,
+          params: args
+        });
+        break;
+
+      case 'get_insight_detail':
+        if (!args.insight_id) {
+          throw new Error('insight_id is required');
+        }
+        response = await axios.get(`${CLOSEDLOOP_SERVER_URL}/feedbacks/${args.insight_id}`, {
+          headers
+        });
+        break;
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(response.data, null, 2)
+        }
+      ]
+    };
+
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Error: ${error.message}`
+        }
+      ],
+      isError: true
+    };
+  }
+});
+
+// Start the server
+const transport = new StdioServerTransport();
+server.connect(transport);
+
+console.error('ClosedLoop MCP Server started');

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@closedloop-ai/mcp-client",
+  "version": "1.0.0",
+  "description": "ClosedLoop MCP Server for AI client integration",
+  "main": "index.js",
+  "bin": {
+    "closedloop-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "axios": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "closedloop",
+    "feedback",
+    "analytics"
+  ],
+  "author": "ClosedLoop",
+  "license": "MIT"
+}