@metacells/mcellui-mcp-server 0.1.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/README.md ADDED
@@ -0,0 +1,159 @@
1
+ # @nativeui/mcp-server
2
+
3
+ Model Context Protocol (MCP) server for nativeui - enables AI assistants like Claude Code to help build React Native apps with nativeui components.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install -g @nativeui/mcp-server
9
+ ```
10
+
11
+ Or use directly in your MCP configuration.
12
+
13
+ ## Configuration
14
+
15
+ ### Claude Code
16
+
17
+ Add to `~/.claude/settings.json`:
18
+
19
+ ```json
20
+ {
21
+ "mcpServers": {
22
+ "nativeui": {
23
+ "command": "npx",
24
+ "args": ["@nativeui/mcp-server"]
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+ ### VS Code (Cline/Continue)
31
+
32
+ ```json
33
+ {
34
+ "mcpServers": {
35
+ "nativeui": {
36
+ "command": "npx",
37
+ "args": ["@nativeui/mcp-server"]
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ ## Available Tools
44
+
45
+ ### `nativeui_list_components`
46
+
47
+ List all available components with optional filtering.
48
+
49
+ ```typescript
50
+ {
51
+ category?: string; // "Inputs", "Layout", "Data Display", etc.
52
+ type?: string; // "ui", "block", "screen"
53
+ }
54
+ ```
55
+
56
+ ### `nativeui_get_component`
57
+
58
+ Get the full source code for a component.
59
+
60
+ ```typescript
61
+ {
62
+ name: string; // "button", "card", "input"
63
+ }
64
+ ```
65
+
66
+ ### `nativeui_add_component`
67
+
68
+ Get CLI instructions to add a component.
69
+
70
+ ```typescript
71
+ {
72
+ name: string; // Component name to add
73
+ }
74
+ ```
75
+
76
+ ### `nativeui_suggest_component`
77
+
78
+ Get AI-powered component suggestions based on what you want to build.
79
+
80
+ ```typescript
81
+ {
82
+ description: string; // "a login form with email and password"
83
+ }
84
+ ```
85
+
86
+ ### `nativeui_create_component`
87
+
88
+ Get a guide and template for creating new custom components.
89
+
90
+ ```typescript
91
+ {
92
+ name: string; // Component name
93
+ template?: string; // "basic", "animated", "pressable", "input"
94
+ withForwardRef?: boolean;
95
+ }
96
+ ```
97
+
98
+ ### `nativeui_customize_theme`
99
+
100
+ Get guidance on customizing the nativeui theme.
101
+
102
+ ```typescript
103
+ {
104
+ aspect?: string; // "colors", "radius", "fonts", "all"
105
+ preset?: string; // Theme preset as base
106
+ }
107
+ ```
108
+
109
+ ### `nativeui_doctor`
110
+
111
+ Check project setup and diagnose common issues.
112
+
113
+ ```typescript
114
+ {
115
+ projectPath?: string; // Path to project root
116
+ }
117
+ ```
118
+
119
+ ### `nativeui_search`
120
+
121
+ Search components by name, description, or keywords.
122
+
123
+ ```typescript
124
+ {
125
+ query: string; // Search query
126
+ }
127
+ ```
128
+
129
+ ## Available Resources
130
+
131
+ | URI | Description |
132
+ |-----|-------------|
133
+ | `nativeui://registry` | Full component registry as JSON |
134
+ | `nativeui://tokens` | Design tokens (colors, spacing, etc.) |
135
+ | `nativeui://docs/getting-started` | Getting started guide |
136
+ | `nativeui://docs/component-patterns` | Component patterns guide |
137
+ | `nativeui://docs/theme-customization` | Theme customization guide |
138
+ | `nativeui://docs/animation-patterns` | Animation patterns guide |
139
+ | `nativeui://docs/accessibility` | Accessibility guide |
140
+
141
+ ## Usage Example
142
+
143
+ With Claude Code configured, you can ask:
144
+
145
+ - "What nativeui components are available for forms?"
146
+ - "Show me the source code for the Button component"
147
+ - "I need to build a login screen, what components should I use?"
148
+ - "How do I customize the theme colors?"
149
+ - "Create a new animated card component"
150
+
151
+ ## Links
152
+
153
+ - [Documentation](https://mcellui.dev/docs/mcp)
154
+ - [CLI](https://www.npmjs.com/package/@nativeui/cli)
155
+ - [GitHub](https://github.com/metacells/nativeui)
156
+
157
+ ## License
158
+
159
+ MIT
@@ -0,0 +1,2 @@
1
+
2
+ export { }