@atlashub/smartstack-mcp 1.2.1 → 1.2.2

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 (9) hide show
  1. package/README.md +88 -155
  2. package/config/default-config.json +62 -62
  3. package/dist/index.js +1 -1
  4. package/dist/index.js.map +1 -1
  5. package/package.json +1 -1
  6. package/templates/component.tsx.hbs +298 -298
  7. package/templates/controller.cs.hbs +166 -166
  8. package/templates/entity-extension.cs.hbs +87 -87
  9. package/templates/service-extension.cs.hbs +53 -53
package/README.md CHANGED
@@ -1,155 +1,88 @@
1
- # @atlashub/smartstack-mcp
2
-
3
- MCP (Model Context Protocol) server for SmartStack/AtlasHub platform development.
4
-
5
- ## Installation
6
-
7
- ### Option 1: Claude Code CLI (Recommended)
8
-
9
- ```bash
10
- # Add SmartStack MCP (user-level, available in all projects)
11
- claude mcp add smartstack -s user -e SMARTSTACK_PROJECT_PATH=C:/path/to/your/SmartStack.app -- npx -y @atlashub/smartstack-mcp
12
-
13
- # Or project-level (only for current project)
14
- claude mcp add smartstack -e SMARTSTACK_PROJECT_PATH=C:/path/to/your/SmartStack.app -- npx -y @atlashub/smartstack-mcp
15
-
16
- # With global install (faster startup)
17
- npm install -g @atlashub/smartstack-mcp
18
- claude mcp add smartstack -s user -e SMARTSTACK_PROJECT_PATH=C:/path/to/your/SmartStack.app -- smartstack-mcp
19
- ```
20
-
21
- **Verify installation:**
22
- ```bash
23
- claude mcp list
24
- ```
25
-
26
- ### Option 2: Visual Studio Code (Extension Claude Code)
27
-
28
- Create a `.mcp.json` file at the root of your project:
29
-
30
- ```json
31
- {
32
- "mcpServers": {
33
- "smartstack": {
34
- "command": "npx",
35
- "args": ["-y", "@atlashub/smartstack-mcp"],
36
- "env": {
37
- "SMARTSTACK_PROJECT_PATH": "C:/path/to/your/SmartStack.app"
38
- }
39
- }
40
- }
41
- }
42
- ```
43
-
44
- Or with global install (faster startup):
45
-
46
- ```json
47
- {
48
- "mcpServers": {
49
- "smartstack": {
50
- "command": "smartstack-mcp",
51
- "env": {
52
- "SMARTSTACK_PROJECT_PATH": "C:/path/to/your/SmartStack.app"
53
- }
54
- }
55
- }
56
- }
57
- ```
58
-
59
- **Steps:**
60
- 1. Install the Claude Code extension in VS Code
61
- 2. Create the `.mcp.json` file at project root
62
- 3. Reload VS Code or the extension
63
- 4. The MCP server will be available in Claude Code panel
64
-
65
- ### Option 3: Claude Desktop
66
-
67
- Add to `claude_desktop_config.json`:
68
-
69
- - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
70
- - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
71
-
72
- ```json
73
- {
74
- "mcpServers": {
75
- "smartstack": {
76
- "command": "npx",
77
- "args": ["-y", "@atlashub/smartstack-mcp"],
78
- "env": {
79
- "SMARTSTACK_PROJECT_PATH": "C:/path/to/your/SmartStack.app"
80
- }
81
- }
82
- }
83
- }
84
- ```
85
-
86
- ### Option 4: Manual Execution
87
-
88
- ```bash
89
- # Using npx (no install required)
90
- SMARTSTACK_PROJECT_PATH=/path/to/project npx @atlashub/smartstack-mcp
91
-
92
- # Or if installed globally
93
- npm install -g @atlashub/smartstack-mcp
94
- SMARTSTACK_PROJECT_PATH=/path/to/project smartstack-mcp
95
- ```
96
-
97
- ## Adding Context7 (Optional)
98
-
99
- Context7 provides up-to-date documentation lookups for any library.
100
-
101
- **Claude Code CLI:**
102
- ```bash
103
- claude mcp add context7 -s user -- npx -y @upstash/context7-mcp
104
- ```
105
-
106
- **VS Code (.mcp.json):**
107
- ```json
108
- {
109
- "mcpServers": {
110
- "smartstack": {
111
- "command": "npx",
112
- "args": ["-y", "@atlashub/smartstack-mcp"],
113
- "env": {
114
- "SMARTSTACK_PROJECT_PATH": "C:/path/to/your/SmartStack.app"
115
- }
116
- },
117
- "context7": {
118
- "command": "npx",
119
- "args": ["-y", "@upstash/context7-mcp"]
120
- }
121
- }
122
- }
123
- ```
124
-
125
- ## Configuration
126
-
127
- | Variable | Description | Required |
128
- |----------|-------------|----------|
129
- | `SMARTSTACK_PROJECT_PATH` | Path to your SmartStack.app project | Yes |
130
- | `SMARTSTACK_API_URL` | SmartStack API URL | No |
131
- | `LOG_LEVEL` | Logging level (debug, info, warn, error) | No |
132
-
133
- ## Features
134
-
135
- ### Tools
136
-
137
- | Tool | Description |
138
- |------|-------------|
139
- | `validate_conventions` | Validate AtlasHub conventions |
140
- | `check_migrations` | Analyze EF Core migrations |
141
- | `scaffold_extension` | Generate code scaffolding |
142
- | `api_docs` | Get API documentation |
143
-
144
- ### Resources
145
-
146
- | Resource URI | Description |
147
- |--------------|-------------|
148
- | `smartstack://conventions` | Naming conventions |
149
- | `smartstack://project` | Project information |
150
- | `smartstack://api/{endpoint}` | API documentation |
151
- | `smartstack://schema/{table}` | Database schema |
152
-
153
- ## License
154
-
155
- MIT - AtlasHub
1
+ # @atlashub/smartstack-mcp
2
+
3
+ MCP server for SmartStack/AtlasHub platform development.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ npm install -g @atlashub/smartstack-mcp
9
+ claude mcp add -s user smartstack -- smartstack-mcp
10
+ ```
11
+
12
+ ## Installation
13
+
14
+ ### Claude Code CLI
15
+
16
+ ```bash
17
+ claude mcp add -s user smartstack -- npx -y @atlashub/smartstack-mcp
18
+ ```
19
+
20
+ ### VS Code
21
+
22
+ Create `.mcp.json` at project root:
23
+
24
+ ```json
25
+ {
26
+ "mcpServers": {
27
+ "smartstack": {
28
+ "command": "npx",
29
+ "args": ["-y", "@atlashub/smartstack-mcp"]
30
+ }
31
+ }
32
+ }
33
+ ```
34
+
35
+ ### Claude Desktop
36
+
37
+ Config file location:
38
+ - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
39
+ - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
40
+
41
+ ```json
42
+ {
43
+ "mcpServers": {
44
+ "smartstack": {
45
+ "command": "npx",
46
+ "args": ["-y", "@atlashub/smartstack-mcp"]
47
+ }
48
+ }
49
+ }
50
+ ```
51
+
52
+ ## Context7 (Optional)
53
+
54
+ ```bash
55
+ claude mcp add context7 -s user -- npx -y @upstash/context7-mcp
56
+ ```
57
+
58
+ ## Configuration
59
+
60
+ | Variable | Description | Required |
61
+ |----------|-------------|----------|
62
+ | `SMARTSTACK_PROJECT_PATH` | Path to your SmartStack.app project | Yes |
63
+ | `SMARTSTACK_API_URL` | SmartStack API URL | No |
64
+ | `LOG_LEVEL` | Logging level (debug, info, warn, error) | No |
65
+
66
+ ## Features
67
+
68
+ ### Tools
69
+
70
+ | Tool | Description |
71
+ |------|-------------|
72
+ | `validate_conventions` | Validate AtlasHub conventions |
73
+ | `check_migrations` | Analyze EF Core migrations |
74
+ | `scaffold_extension` | Generate code scaffolding |
75
+ | `api_docs` | Get API documentation |
76
+
77
+ ### Resources
78
+
79
+ | Resource URI | Description |
80
+ |--------------|-------------|
81
+ | `smartstack://conventions` | Naming conventions |
82
+ | `smartstack://project` | Project information |
83
+ | `smartstack://api/{endpoint}` | API documentation |
84
+ | `smartstack://schema/{table}` | Database schema |
85
+
86
+ ## License
87
+
88
+ MIT - AtlasHub
package/config/default-config.json CHANGED
@@ -1,62 +1,62 @@
1
- {
2
- "$schema": "https://atlashub.ch/schemas/smartstack-mcp-config.json",
3
- "version": "1.0.0",
4
- "smartstack": {
5
- "projectPath": "D:/SmartStack.app/features/Rework-to-package",
6
- "apiUrl": "https://localhost:7055",
7
- "apiEnabled": true
8
- },
9
- "conventions": {
10
- "schemas": {
11
- "platform": "core",
12
- "extensions": "extensions"
13
- },
14
- "tablePrefixes": [
15
- "auth_",
16
- "nav_",
17
- "usr_",
18
- "ai_",
19
- "cfg_",
20
- "wkf_",
21
- "support_",
22
- "entra_",
23
- "ref_",
24
- "loc_",
25
- "lic_"
26
- ],
27
- "migrationFormat": "YYYYMMDD_NNN_{Description}",
28
- "namespaces": {
29
- "domain": "SmartStack.Domain",
30
- "application": "SmartStack.Application",
31
- "infrastructure": "SmartStack.Infrastructure",
32
- "api": "SmartStack.Api"
33
- },
34
- "servicePattern": {
35
- "interface": "I{Name}Service",
36
- "implementation": "{Name}Service"
37
- }
38
- },
39
- "efcore": {
40
- "contexts": [
41
- {
42
- "name": "ApplicationDbContext",
43
- "projectPath": "auto-detect",
44
- "migrationsFolder": "Migrations"
45
- }
46
- ],
47
- "validation": {
48
- "checkModelSnapshot": true,
49
- "checkMigrationOrder": true,
50
- "requireBuildSuccess": true
51
- }
52
- },
53
- "scaffolding": {
54
- "outputPath": "auto-detect",
55
- "templates": {
56
- "service": "templates/service-extension.cs.hbs",
57
- "entity": "templates/entity-extension.cs.hbs",
58
- "controller": "templates/controller.cs.hbs",
59
- "component": "templates/component.tsx.hbs"
60
- }
61
- }
62
- }
1
+ {
2
+ "$schema": "https://atlashub.ch/schemas/smartstack-mcp-config.json",
3
+ "version": "1.0.0",
4
+ "smartstack": {
5
+ "projectPath": "D:/SmartStack.app/features/Rework-to-package",
6
+ "apiUrl": "https://localhost:7055",
7
+ "apiEnabled": true
8
+ },
9
+ "conventions": {
10
+ "schemas": {
11
+ "platform": "core",
12
+ "extensions": "extensions"
13
+ },
14
+ "tablePrefixes": [
15
+ "auth_",
16
+ "nav_",
17
+ "usr_",
18
+ "ai_",
19
+ "cfg_",
20
+ "wkf_",
21
+ "support_",
22
+ "entra_",
23
+ "ref_",
24
+ "loc_",
25
+ "lic_"
26
+ ],
27
+ "migrationFormat": "YYYYMMDD_NNN_{Description}",
28
+ "namespaces": {
29
+ "domain": "SmartStack.Domain",
30
+ "application": "SmartStack.Application",
31
+ "infrastructure": "SmartStack.Infrastructure",
32
+ "api": "SmartStack.Api"
33
+ },
34
+ "servicePattern": {
35
+ "interface": "I{Name}Service",
36
+ "implementation": "{Name}Service"
37
+ }
38
+ },
39
+ "efcore": {
40
+ "contexts": [
41
+ {
42
+ "name": "ApplicationDbContext",
43
+ "projectPath": "auto-detect",
44
+ "migrationsFolder": "Migrations"
45
+ }
46
+ ],
47
+ "validation": {
48
+ "checkModelSnapshot": true,
49
+ "checkMigrationOrder": true,
50
+ "requireBuildSuccess": true
51
+ }
52
+ },
53
+ "scaffolding": {
54
+ "outputPath": "auto-detect",
55
+ "templates": {
56
+ "service": "templates/service-extension.cs.hbs",
57
+ "entity": "templates/entity-extension.cs.hbs",
58
+ "controller": "templates/controller.cs.hbs",
59
+ "component": "templates/component.tsx.hbs"
60
+ }
61
+ }
62
+ }
package/dist/index.js CHANGED
@@ -280,7 +280,7 @@ var ConventionsConfigSchema = z.object({
280
280
  "loc_",
281
281
  "lic_"
282
282
  ]),
283
- migrationFormat: z.string().default("YYYYMMDD_NNN_{Description}"),
283
+ migrationFormat: z.string().default("{context}_v{version}_{sequence}_{Description}"),
284
284
  namespaces: z.object({
285
285
  domain: z.string(),
286
286
  application: z.string(),