reportdash-datastore-mcp 1.0.0

package/README.md

@@ -0,0 +1,233 @@
+# ReportDash DataStore MCP for Claude Desktop
+
+Connect your ReportDash DataStore sources to Claude Desktop in 5 minutes.
+
+## Prerequisites
+
+- **Claude Desktop** - [Download here](https://claude.ai/download)
+- **Node.js** (v14 or higher) - [Download here](https://nodejs.org/)
+- **ReportDash DataStore account** with API access
+
+## Setup (5 minutes)
+
+### Step 1: Get Your API Key
+
+1. Open ReportDash DataStore app
+2. Go to **Settings** → **API Keys** (or **Integrations**)
+3. Click **"Generate New Key"**
+4. Copy the API key (starts with `rd_...`)
+
+### Step 2: Configure Claude Desktop
+
+#### On macOS:
+```bash
+# Open the config file
+nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
+```
+
+#### On Windows:
+
+1. Press `Win + R`
+2. Type: `%APPDATA%\Claude`
+3. Open `claude_desktop_config.json` in Notepad
+
+#### On Linux:
+```bash
+# Open the config file
+nano ~/.config/Claude/claude_desktop_config.json
+```
+
+### Step 3: Add Configuration
+
+Paste this into the config file (replace `YOUR_API_KEY_HERE` with your actual key):
+```json
+{
+  "mcpServers": {
+    "reportdash-datastore": {
+      "command": "npx",
+      "args": ["-y", "@reportdash/datastore-mcp"],
+      "env": {
+        "REPORTDASH_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+**💡 If you already have other MCP servers configured:**
+```json
+{
+  "mcpServers": {
+    "existing-server": {
+      "command": "...",
+      "args": ["..."]
+    },
+    "reportdash-datastore": {
+      "command": "npx",
+      "args": ["-y", "@reportdash/datastore-mcp"],
+      "env": {
+        "REPORTDASH_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+### Step 4: Restart Claude Desktop
+
+Close and reopen Claude Desktop completely.
+
+### Step 5: Test It!
+
+Ask Claude:
+```
+"List my reportdash datastore sources"
+```
+
+or
+```
+"Show me the tables for my Google Ads data in datastore"
+```
+
+🎉 **Done!** Claude can now access your ReportDash DataStore.
+
+---
+
+## Testing Your Connection
+
+Before configuring Claude Desktop, test your connection:
+```bash
+REPORTDASH_API_KEY=your_key_here npx @reportdash/datastore-mcp --test
+```
+
+You should see:
+```
+✅ Connection successful!
+✅ API key is valid
+
+🎉 You can now use ReportDash DataStore in Claude Desktop!
+```
+
+---
+
+## Troubleshooting
+
+### ❌ "command not found: npx"
+
+**Solution:** Install Node.js from https://nodejs.org/
+
+After installing, verify:
+```bash
+node --version
+npx --version
+```
+
+### ❌ "REPORTDASH_API_KEY environment variable is required"
+
+**Solution:** Check your `claude_desktop_config.json`:
+- Make sure `REPORTDASH_API_KEY` is spelled correctly
+- Make sure your API key is inside quotes
+- Make sure there are no extra spaces
+
+### ❌ "API key is invalid"
+
+**Solution:** 
+1. Generate a new API key in ReportDash DataStore app
+2. Update your `claude_desktop_config.json` with the new key
+3. Restart Claude Desktop
+
+### ❌ Claude says "I don't have access to reportdash datastore"
+
+**Solution:**
+1. Verify your config file is saved correctly
+2. Make sure you restarted Claude Desktop completely (not just the window)
+3. Check Claude Desktop logs:
+   - **Mac:** `~/Library/Logs/Claude/`
+   - **Windows:** `%APPDATA%\Claude\logs\`
+
+### ❌ Connection timeout
+
+**Solution:**
+- Check your internet connection
+- If using a custom API URL, verify it's correct
+- Check if your firewall is blocking Node.js
+
+---
+
+## Advanced Configuration
+
+### Custom API URL (for self-hosted deployments)
+```json
+{
+  "mcpServers": {
+    "reportdash-datastore": {
+      "command": "npx",
+      "args": ["-y", "@reportdash/datastore-mcp"],
+      "env": {
+        "REPORTDASH_API_KEY": "your_key_here",
+        "REPORTDASH_API_URL": "https://your-domain.com/api/mcp/v1"
+      }
+    }
+  }
+}
+```
+
+### Development/Staging Environment
+```json
+{
+  "mcpServers": {
+    "reportdash-datastore-staging": {
+      "command": "npx",
+      "args": ["-y", "@reportdash/datastore-mcp"],
+      "env": {
+        "REPORTDASH_API_KEY": "staging_key_here",
+        "REPORTDASH_API_URL": "https://staging-api.reportdash.com/api/mcp/v1"
+      }
+    }
+  }
+}
+```
+
+---
+
+## What You Can Do
+
+Once connected, you can ask Claude to:
+
+- **List sources:** "Show me all my connected data sources in datastore"
+- **Query data:** "Get my Google Ads clicks from datastore for the last 7 days"
+- **Analyze trends:** "Compare this month's performance to last month using datastore"
+- **Create visualizations:** "Create a chart of my campaign performance from datastore"
+- **Generate reports:** "Create a weekly summary of all my marketing channels"
+
+---
+
+## Support
+
+- 📧 **Email:** support@reportdash.com
+- 📖 **Documentation:** https://docs.reportdash.com
+- 💬 **Community:** https://community.reportdash.com
+- 🐛 **Report Issues:** https://github.com/reportdash/datastore-mcp/issues
+
+---
+
+## Privacy & Security
+
+- Your API key is stored locally on your computer
+- The MCP server runs locally and only forwards requests to ReportDash DataStore API
+- No data is stored or logged by the MCP server
+- All communication uses HTTPS encryption
+
+---
+
+## Uninstalling
+
+1. Remove the `reportdash-datastore` section from `claude_desktop_config.json`
+2. Restart Claude Desktop
+3. (Optional) Revoke your API key in ReportDash DataStore app settings
+
+---
+
+## License
+
+MIT License - see LICENSE file for details

package/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const http = require('http');
+const readline = require('readline');
+const { URL } = require('url');
+
+// Configuration
+const API_KEY = process.env.REPORTDASH_API_KEY;
+const API_URL = process.env.REPORTDASH_API_URL || 'https://datastore.reportdash.com/api/mcp/v1';
+
+// Validate configuration
+if (!API_KEY) {
+  console.error(JSON.stringify({
+    jsonrpc: '2.0',
+    error: {
+      code: -32600,
+      message: 'REPORTDASH_API_KEY environment variable is required. Get your API key from ReportDash DataStore app settings.'
+    }
+  }));
+  process.exit(1);
+}
+
+// Test mode
+if (process.argv.includes('--test')) {
+  testConnection();
+  return;
+}
+
+// MCP Server: Read from stdin, forward to API, write to stdout
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false
+});
+
+rl.on('line', (line) => {
+  if (!line.trim()) return;
+
+  try {
+    const mcpRequest = JSON.parse(line);
+    forwardToAPI(mcpRequest);
+  } catch (error) {
+    console.error(JSON.stringify({
+      jsonrpc: '2.0',
+      error: {
+        code: -32700,
+        message: 'Parse error: ' + error.message
+      },
+      id: null
+    }));
+  }
+});
+
+function forwardToAPI(mcpRequest) {
+  const url = new URL(API_URL);
+  const isHttps = url.protocol === 'https:';
+  const client = isHttps ? https : http;
+
+  const options = {
+    hostname: url.hostname,
+    port: url.port || (isHttps ? 443 : 80),
+    path: url.pathname,
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-Api-Key': API_KEY,
+      'User-Agent': 'ReportDash-DataStore-MCP/1.0'
+    },
+    timeout: 30000 // 30 second timeout
+  };
+
+  const req = client.request(options, (res) => {
+    let data = '';
+
+    res.on('data', (chunk) => {
+      data += chunk;
+    });
+
+    res.on('end', () => {
+      if (res.statusCode === 200) {
+        console.log(data);
+      } else {
+        console.error(JSON.stringify({
+          jsonrpc: '2.0',
+          error: {
+            code: res.statusCode,
+            message: `API error: ${res.statusCode} - ${data}`,
+            data: { statusCode: res.statusCode, body: data }
+          },
+          id: mcpRequest.id || null
+        }));
+      }
+    });
+  });
+
+  req.on('error', (error) => {
+    console.error(JSON.stringify({
+      jsonrpc: '2.0',
+      error: {
+        code: -32603,
+        message: 'Network error: ' + error.message,
+        data: { error: error.message }
+      },
+      id: mcpRequest.id || null
+    }));
+  });
+
+  req.on('timeout', () => {
+    req.destroy();
+    console.error(JSON.stringify({
+      jsonrpc: '2.0',
+      error: {
+        code: -32603,
+        message: 'Request timeout after 30 seconds'
+      },
+      id: mcpRequest.id || null
+    }));
+  });
+
+  req.write(JSON.stringify(mcpRequest));
+  req.end();
+}
+
+function testConnection() {
+  console.log('🔍 Testing ReportDash DataStore connection...\n');
+  console.log(`API URL: ${API_URL}`);
+  console.log(`API Key: ${API_KEY.substring(0, 10)}...${API_KEY.substring(API_KEY.length - 4)}\n`);
+
+  const url = new URL(API_URL.replace('/mcp/v1', '/health'));
+  const isHttps = url.protocol === 'https:';
+  const client = isHttps ? https : http;
+
+  const options = {
+    hostname: url.hostname,
+    port: url.port || (isHttps ? 443 : 80),
+    path: url.pathname,
+    method: 'GET',
+    headers: {
+      'X-Api-Key': API_KEY
+    },
+    timeout: 10000
+  };
+
+  const req = client.request(options, (res) => {
+    let data = '';
+    res.on('data', (chunk) => { data += chunk; });
+    res.on('end', () => {
+      if (res.statusCode === 200) {
+        console.log('✅ Connection successful!');
+        console.log('✅ API key is valid');
+        console.log('\n🎉 You can now use ReportDash DataStore in Claude Desktop!');
+        console.log('\nTry asking Claude: "list my reportdash datastore sources"');
+      } else {
+        console.log('❌ Connection failed');
+        console.log(`Status: ${res.statusCode}`);
+        console.log(`Response: ${data}`);
+        console.log('\n💡 Check your API key in ReportDash DataStore app settings');
+      }
+    });
+  });
+
+  req.on('error', (error) => {
+    console.log('❌ Connection error:', error.message);
+    console.log('\n💡 Check your internet connection and API URL');
+  });
+
+  req.on('timeout', () => {
+    req.destroy();
+    console.log('❌ Connection timeout');
+    console.log('\n💡 Check your internet connection');
+  });
+
+  req.end();
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "reportdash-datastore-mcp",
+  "version": "1.0.0",
+  "description": "ReportDash DataStore MCP server for Claude Desktop",
+  "main": "index.js",
+  "bin": {
+    "reportdash-datastore-mcp": "./index.js"
+  },
+  "scripts": {
+    "test": "node index.js --test"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "reportdash",
+    "datastore",
+    "analytics",
+    "reporting"
+  ],
+  "author": "ReportDash",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reportdash/datastore-mcp-claude-desktop.git"
+  },
+  "homepage": "https://reportdash.com",
+  "bugs": {
+    "url": "https://github.com/reportdash/datastore-mcp-claude-desktop/issues"
+  }
+}