@dcluttr/dclare-mcp 0.1.2 → 0.1.3

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.
Files changed (2) hide show
  1. package/README.md +92 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,4 +1,94 @@
1
- # Dclare MCP Server (Node.js)
1
+ # Dclare MCP Server
2
2
 
3
+ Talk to your Dcluttr data using natural language — powered by Claude.
3
4
 
4
- See [mcp.md](/Users/namanaggarwal/Documents/dcluttr/talk-to-data-mcp-server/docs/cube-security.md).
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. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dcluttr/dclare-mcp",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "type": "module",
5
5
  "description": "MCP server for secure talk-to-data on Cube + ClickHouse",
6
6
  "bin": {