@tekton-ui/mcp-server 0.3.5 → 0.4.0
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/dist/cli/agent-md-templates.d.ts.map +1 -1
- package/dist/cli/agent-md-templates.js +34 -53
- package/dist/cli/agent-md-templates.js.map +1 -1
- package/dist/cli/guide-template.d.ts.map +1 -1
- package/dist/cli/guide-template.js +8 -10
- package/dist/cli/guide-template.js.map +1 -1
- package/dist/data/component-props.d.ts +30 -0
- package/dist/data/component-props.d.ts.map +1 -0
- package/dist/data/component-props.js +537 -0
- package/dist/data/component-props.js.map +1 -0
- package/dist/index.js +28 -86
- package/dist/index.js.map +1 -1
- package/dist/prompts/getting-started.d.ts.map +1 -1
- package/dist/prompts/getting-started.js +8 -9
- package/dist/prompts/getting-started.js.map +1 -1
- package/dist/prompts/screen-workflow.d.ts +2 -2
- package/dist/prompts/screen-workflow.d.ts.map +1 -1
- package/dist/prompts/screen-workflow.js +64 -61
- package/dist/prompts/screen-workflow.js.map +1 -1
- package/dist/schemas/mcp-schemas.d.ts +628 -652
- package/dist/schemas/mcp-schemas.d.ts.map +1 -1
- package/dist/schemas/mcp-schemas.js +14 -40
- package/dist/schemas/mcp-schemas.js.map +1 -1
- package/dist/tools/get-screen-generation-context.d.ts.map +1 -1
- package/dist/tools/get-screen-generation-context.js +22 -13
- package/dist/tools/get-screen-generation-context.js.map +1 -1
- package/dist/tools/preview-component.d.ts.map +1 -1
- package/dist/tools/preview-component.js +2 -117
- package/dist/tools/preview-component.js.map +1 -1
- package/dist/tools/validate-screen-definition.d.ts.map +1 -1
- package/dist/tools/validate-screen-definition.js +96 -0
- package/dist/tools/validate-screen-definition.js.map +1 -1
- package/package.json +19 -18
- package/LICENSE +0 -21
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAsHpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoLpE"}
|
|
@@ -13,7 +13,7 @@ export function generateClaudeMdSection(framework) {
|
|
|
13
13
|
|
|
14
14
|
### MCP Server Connection
|
|
15
15
|
|
|
16
|
-
Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads
|
|
16
|
+
Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads 15 tools for screen generation.
|
|
17
17
|
|
|
18
18
|
### Authentication (Step 1)
|
|
19
19
|
|
|
@@ -25,23 +25,22 @@ tekton-mcp login
|
|
|
25
25
|
|
|
26
26
|
**Important:** All 6 themes require authentication. No free themes are available.
|
|
27
27
|
|
|
28
|
-
### Screen Generation Workflow (
|
|
28
|
+
### Screen Generation Workflow (3 Steps)
|
|
29
29
|
|
|
30
|
-
**Step 1/
|
|
30
|
+
**Step 1/3:** Gather Context
|
|
31
31
|
- Call \`get-screen-generation-context\` with user's screen description
|
|
32
|
-
- Receive template matches, component suggestions, and schema
|
|
32
|
+
- Receive template matches, component suggestions with inline props/variants, and schema
|
|
33
33
|
|
|
34
|
-
**Step 2/
|
|
34
|
+
**Step 2/3:** Validate Definition
|
|
35
35
|
- Generate Screen Definition JSON based on context
|
|
36
36
|
- Call \`validate-screen-definition\` to verify structure
|
|
37
|
-
-
|
|
37
|
+
- Apply autoFixPatches or fix any errors before proceeding
|
|
38
38
|
|
|
39
|
-
**
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
- Check \`dependencies.external\` field
|
|
39
|
+
**After Validation:** Write React Code Directly
|
|
40
|
+
- Use components and import statements from Step 1 context
|
|
41
|
+
- Apply theme recipes via variant props
|
|
43
42
|
|
|
44
|
-
**Step
|
|
43
|
+
**Step 3/3:** Validate Environment (Optional)
|
|
45
44
|
- Call \`validate-environment\` with project path and required packages
|
|
46
45
|
- Verify Tailwind CSS configuration
|
|
47
46
|
- Show user install commands for missing packages
|
|
@@ -76,11 +75,10 @@ export default function Page() {
|
|
|
76
75
|
- \`list-screen-templates\` - List 13 screen templates
|
|
77
76
|
- \`preview-screen-template\` - Get template structure
|
|
78
77
|
|
|
79
|
-
**Screen Generation (
|
|
80
|
-
- \`get-screen-generation-context\` - Step 1/
|
|
81
|
-
- \`validate-screen-definition\` - Step 2/
|
|
82
|
-
- \`
|
|
83
|
-
- \`validate-environment\` - Step 4/4
|
|
78
|
+
**Screen Generation (3 tools):**
|
|
79
|
+
- \`get-screen-generation-context\` - Step 1/3
|
|
80
|
+
- \`validate-screen-definition\` - Step 2/3
|
|
81
|
+
- \`validate-environment\` - Step 3/3 (Optional)
|
|
84
82
|
|
|
85
83
|
**Quick Prototyping (3 tools):**
|
|
86
84
|
- \`generate-blueprint\` - Quick UI structure
|
|
@@ -99,7 +97,7 @@ export default function Page() {
|
|
|
99
97
|
Claude Code can access built-in prompts for guidance:
|
|
100
98
|
|
|
101
99
|
- \`getting-started\` - Authentication → Theme → Components → Screen generation
|
|
102
|
-
- \`screen-workflow\` - Detailed
|
|
100
|
+
- \`screen-workflow\` - Detailed 3-step workflow with troubleshooting
|
|
103
101
|
|
|
104
102
|
These prompts work across all MCP clients, not just Claude Code.
|
|
105
103
|
|
|
@@ -108,8 +106,7 @@ These prompts work across all MCP clients, not just Claude Code.
|
|
|
108
106
|
1. ❌ Skipping authentication before generating screens
|
|
109
107
|
2. ❌ Using non-existent theme IDs (only 6 exist)
|
|
110
108
|
3. ❌ Skipping validate-screen-definition step
|
|
111
|
-
4. ❌
|
|
112
|
-
5. ❌ Delivering code without verifying Tailwind config
|
|
109
|
+
4. ❌ Delivering code without verifying Tailwind config
|
|
113
110
|
|
|
114
111
|
### Troubleshooting
|
|
115
112
|
|
|
@@ -138,7 +135,7 @@ export function generateAgentsMdSection(framework) {
|
|
|
138
135
|
|
|
139
136
|
### Overview
|
|
140
137
|
|
|
141
|
-
Tekton MCP server provides
|
|
138
|
+
Tekton MCP server provides 15 tools for screen generation via Model Context Protocol (MCP). This guide is for AI agents on platforms like OpenAI Codex, Cursor, Windsurf, and other MCP-compatible clients.
|
|
142
139
|
|
|
143
140
|
### Prerequisites
|
|
144
141
|
|
|
@@ -160,11 +157,11 @@ tekton-mcp login
|
|
|
160
157
|
|
|
161
158
|
**Important:** All 6 themes require valid licenses. There are no free themes available.
|
|
162
159
|
|
|
163
|
-
### Screen Generation Workflow (
|
|
160
|
+
### Screen Generation Workflow (3 Steps)
|
|
164
161
|
|
|
165
162
|
Follow this exact sequence for production-ready screens:
|
|
166
163
|
|
|
167
|
-
#### Step 1/
|
|
164
|
+
#### Step 1/3: Gather Context
|
|
168
165
|
|
|
169
166
|
**Tool:** \`get-screen-generation-context\`
|
|
170
167
|
|
|
@@ -179,9 +176,9 @@ Follow this exact sequence for production-ready screens:
|
|
|
179
176
|
}
|
|
180
177
|
\`\`\`
|
|
181
178
|
|
|
182
|
-
**Output:** Template matches, component suggestions, schema, examples
|
|
179
|
+
**Output:** Template matches, component suggestions with inline props/variants, schema, examples
|
|
183
180
|
|
|
184
|
-
#### Step 2/
|
|
181
|
+
#### Step 2/3: Validate Definition
|
|
185
182
|
|
|
186
183
|
**Tool:** \`validate-screen-definition\`
|
|
187
184
|
|
|
@@ -200,33 +197,17 @@ Follow this exact sequence for production-ready screens:
|
|
|
200
197
|
}
|
|
201
198
|
\`\`\`
|
|
202
199
|
|
|
203
|
-
**Output:** Validation results with errors, warnings, suggestions
|
|
200
|
+
**Output:** Validation results with errors, warnings, suggestions, and autoFix patches
|
|
204
201
|
|
|
205
|
-
**Critical:** Always validate before
|
|
202
|
+
**Critical:** Always validate before writing code. Apply autoFixPatches or fix all errors.
|
|
206
203
|
|
|
207
|
-
####
|
|
204
|
+
#### After Validation: Write React Code Directly
|
|
208
205
|
|
|
209
|
-
**
|
|
206
|
+
**No tool needed** - Write production-ready React code using components from Step 1 context.
|
|
210
207
|
|
|
211
|
-
|
|
208
|
+
Use the import statements and props provided in the context response.
|
|
212
209
|
|
|
213
|
-
|
|
214
|
-
\`\`\`json
|
|
215
|
-
{
|
|
216
|
-
"screenDefinition": { /* from Step 2 */ },
|
|
217
|
-
"outputFormat": "tailwind",
|
|
218
|
-
"options": {
|
|
219
|
-
"typescript": true,
|
|
220
|
-
"prettier": true
|
|
221
|
-
}
|
|
222
|
-
}
|
|
223
|
-
\`\`\`
|
|
224
|
-
|
|
225
|
-
**Output:** React code + dependencies
|
|
226
|
-
|
|
227
|
-
**Critical:** Check \`dependencies.external\` field. If non-empty, proceed to Step 4.
|
|
228
|
-
|
|
229
|
-
#### Step 4/4: Validate Environment
|
|
210
|
+
#### Step 3/3: Validate Environment (Optional)
|
|
230
211
|
|
|
231
212
|
**Tool:** \`validate-environment\`
|
|
232
213
|
|
|
@@ -236,7 +217,7 @@ Follow this exact sequence for production-ready screens:
|
|
|
236
217
|
\`\`\`json
|
|
237
218
|
{
|
|
238
219
|
"projectPath": "/path/to/package.json",
|
|
239
|
-
"requiredPackages": ["
|
|
220
|
+
"requiredPackages": ["@radix-ui/react-slot", "@radix-ui/react-avatar"],
|
|
240
221
|
"checkTailwind": true
|
|
241
222
|
}
|
|
242
223
|
\`\`\`
|
|
@@ -286,7 +267,7 @@ export default function Page() {
|
|
|
286
267
|
Your MCP client may support prompts. If available:
|
|
287
268
|
|
|
288
269
|
- \`getting-started\` - Complete onboarding guide
|
|
289
|
-
- \`screen-workflow\` - Detailed
|
|
270
|
+
- \`screen-workflow\` - Detailed 3-step workflow
|
|
290
271
|
|
|
291
272
|
These provide context to help you guide users effectively.
|
|
292
273
|
|
|
@@ -313,16 +294,16 @@ These provide context to help you guide users effectively.
|
|
|
313
294
|
### Best Practices
|
|
314
295
|
|
|
315
296
|
1. ✅ Always authenticate before generating screens
|
|
316
|
-
2. ✅ Follow all
|
|
317
|
-
3. ✅ Validate before
|
|
318
|
-
4. ✅ Check environment before delivering code (Step
|
|
297
|
+
2. ✅ Follow all 3 workflow steps in order
|
|
298
|
+
3. ✅ Validate before writing code (Step 2)
|
|
299
|
+
4. ✅ Check environment before delivering code (Step 3)
|
|
319
300
|
5. ✅ Inform user about missing dependencies and Tailwind issues
|
|
320
301
|
6. ✅ Use \`strict: true\` for production validation
|
|
321
302
|
|
|
322
|
-
### Quick Reference: All
|
|
303
|
+
### Quick Reference: All 15 Tools
|
|
323
304
|
|
|
324
305
|
**Discovery:** list-themes, preview-theme, list-components, preview-component, list-screen-templates, preview-screen-template
|
|
325
|
-
**Workflow:** get-screen-generation-context, validate-screen-definition,
|
|
306
|
+
**Workflow:** get-screen-generation-context, validate-screen-definition, validate-environment
|
|
326
307
|
**Quick:** generate-blueprint, export-screen, validate_screen, list_tokens
|
|
327
308
|
**Icons:** list-icon-libraries, preview-icon-library
|
|
328
309
|
`;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO
|
|
1
|
+
{"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Ed,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmHJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Dd,CAAC;AACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA4L1D"}
|
|
@@ -70,9 +70,9 @@ tekton-mcp status
|
|
|
70
70
|
|
|
71
71
|
## Screen Generation Workflow
|
|
72
72
|
|
|
73
|
-
Tekton provides a **
|
|
73
|
+
Tekton provides a **3-step workflow** for production-ready screen generation:
|
|
74
74
|
|
|
75
|
-
### Step 1/
|
|
75
|
+
### Step 1/3: Get Context
|
|
76
76
|
|
|
77
77
|
Claude Code calls \`get-screen-generation-context\` with your screen description:
|
|
78
78
|
|
|
@@ -80,21 +80,19 @@ Claude Code calls \`get-screen-generation-context\` with your screen description
|
|
|
80
80
|
"Create a user dashboard with profile card and recent activity"
|
|
81
81
|
\`\`\`
|
|
82
82
|
|
|
83
|
-
Returns: Template matches, component suggestions, Screen Definition schema
|
|
83
|
+
Returns: Template matches, component suggestions with inline props/variants, Screen Definition schema
|
|
84
84
|
|
|
85
|
-
### Step 2/
|
|
85
|
+
### Step 2/3: Validate Definition
|
|
86
86
|
|
|
87
87
|
Claude Code generates a Screen Definition JSON and calls \`validate-screen-definition\`:
|
|
88
88
|
|
|
89
|
-
Returns: Validation results, errors (if any), improvement suggestions
|
|
89
|
+
Returns: Validation results, errors with auto-fix patches (if any), improvement suggestions
|
|
90
90
|
|
|
91
|
-
###
|
|
91
|
+
### After Validation: Write Code
|
|
92
92
|
|
|
93
|
-
Claude Code
|
|
93
|
+
Claude Code writes React code directly using the components and props from Step 1 context.
|
|
94
94
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
### Step 4/4: Validate Environment
|
|
95
|
+
### Step 3/3: Validate Environment (Optional)
|
|
98
96
|
|
|
99
97
|
Claude Code calls \`validate-environment\` to check your project:
|
|
100
98
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guide-template.js","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,MAAM,aAAa,GACjB,SAAS,KAAK,QAAQ;QACpB,CAAC,CAAC;;;;;;;;;;;;;;EAcN;QACI,CAAC,CAAC;;;;;;;;;;;;;;;;oBAgBY,CAAC;IAEnB,OAAO
|
|
1
|
+
{"version":3,"file":"guide-template.js","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,MAAM,aAAa,GACjB,SAAS,KAAK,QAAQ;QACpB,CAAC,CAAC;;;;;;;;;;;;;;EAcN;QACI,CAAC,CAAC;;;;;;;;;;;;;;;;oBAgBY,CAAC;IAEnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoEP,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFd,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared Component Props Data Module
|
|
3
|
+
* 실제 @tekton-ui/ui 컴포넌트에서 추출한 Tier 1 (15개 core) props/variants 데이터
|
|
4
|
+
*
|
|
5
|
+
* 사용처:
|
|
6
|
+
* - preview-component.ts: 컴포넌트 상세 정보 제공
|
|
7
|
+
* - get-screen-generation-context.ts: 인라인 props 컨텍스트 제공
|
|
8
|
+
* - validate-screen-definition.ts: props 유효성 검증
|
|
9
|
+
*/
|
|
10
|
+
import type { PropDefinition, Variant, UsageExample } from '../schemas/mcp-schemas.js';
|
|
11
|
+
export interface ComponentPropsData {
|
|
12
|
+
props: PropDefinition[];
|
|
13
|
+
variants?: Variant[];
|
|
14
|
+
subComponents?: string[];
|
|
15
|
+
dependencies: {
|
|
16
|
+
internal: string[];
|
|
17
|
+
external: string[];
|
|
18
|
+
};
|
|
19
|
+
examples?: UsageExample[];
|
|
20
|
+
accessibility?: string;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* 컴포넌트 ID로 props 데이터 조회
|
|
24
|
+
*/
|
|
25
|
+
export declare function getComponentPropsData(componentId: string): ComponentPropsData | undefined;
|
|
26
|
+
/**
|
|
27
|
+
* 모든 컴포넌트 props 데이터가 있는 컴포넌트 ID 목록 반환
|
|
28
|
+
*/
|
|
29
|
+
export declare function getComponentIdsWithProps(): string[];
|
|
30
|
+
//# sourceMappingURL=component-props.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../../src/data/component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuhBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}
|