@dcluttr/dclare-mcp 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +92 -2
- package/context/datasets.json +6226 -1362
- package/dist/config/env.js +3 -3
- package/dist/index.js +142 -68
- package/dist/services/auth-service.js +47 -14
- package/dist/services/cube-client.js +41 -7
- package/dist/services/langfuse-hook.js +72 -31
- package/dist/services/query-service.js +2 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,94 @@
|
|
|
1
|
-
# Dclare MCP Server
|
|
1
|
+
# Dclare MCP Server
|
|
2
2
|
|
|
3
|
+
Talk to your Dcluttr data using natural language — powered by Claude.
|
|
3
4
|
|
|
4
|
-
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Setup Guide (Claude Code)
|
|
8
|
+
|
|
9
|
+
### Step 1: Install Node.js
|
|
10
|
+
|
|
11
|
+
You need Node.js version 20 or later.
|
|
12
|
+
|
|
13
|
+
1. Go to **https://nodejs.org**
|
|
14
|
+
2. Download the **LTS** version (the big green button)
|
|
15
|
+
3. Open the downloaded file and follow the installer prompts
|
|
16
|
+
4. Once done, open your **Terminal** app and run:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
node --version
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
You should see something like `v20.x.x` or higher. If you see an error, restart your Terminal and try again.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
### Step 2: Install Claude Code
|
|
27
|
+
|
|
28
|
+
1. Open **Terminal**
|
|
29
|
+
2. Run:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
npm install -g @anthropic-ai/claude-code
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
3. After it finishes, launch Claude Code by running:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
claude
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
4. It will ask you to log in to your Anthropic account — follow the on-screen instructions.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### Step 3: Add the Dclare MCP Server
|
|
46
|
+
|
|
47
|
+
In your **Terminal**, run this single command:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
claude mcp add-json dclare-mcp '{"type":"stdio","command":"npx","args":["-y","@dcluttr/dclare-mcp@latest"],"allowedTools":["mcp__dclare-mcp__*"]}'
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
This registers the MCP server **and** pre-approves all its tools so Claude won't ask for permission each time.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
### Step 4: Start using it
|
|
58
|
+
|
|
59
|
+
1. Open **Terminal** and run:
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
claude
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
2. First, log in to your Dcluttr account by typing:
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
Log me in to Dcluttr with email: your@email.com and password: yourpassword
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
3. Once logged in, you can ask questions about your data in plain English:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
What were my top 10 SKUs on Blinkit last week by sales?
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
Show me city-wise sales for the last 30 days
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
Compare my ad spend vs revenue on Zepto this month
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Troubleshooting
|
|
88
|
+
|
|
89
|
+
| Problem | Fix |
|
|
90
|
+
|---|---|
|
|
91
|
+
| `node: command not found` | Restart your Terminal after installing Node.js. If still broken, reinstall Node.js from https://nodejs.org. |
|
|
92
|
+
| `claude: command not found` | Run `npm install -g @anthropic-ai/claude-code` again. |
|
|
93
|
+
| "Not logged in" errors when querying data | Say `Log me in to Dcluttr` and provide your email and password. |
|
|
94
|
+
| MCP server not showing up | Run `claude mcp list` to check. If missing, re-run the Step 3 command. |
|