@bearnie/mcp 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,129 @@
1
+ # Bearnie MCP Server
2
+
3
+ An MCP (Model Context Protocol) server that enables AI assistants like Claude, GitHub Copilot, and others to interact with the Bearnie UI component library.
4
+
5
+ ## Features
6
+
7
+ - **List Components**: Browse all available Bearnie components
8
+ - **Search Components**: Find components by name, description, or category
9
+ - **Get Component Details**: View component source code and dependencies
10
+ - **Add Components**: Install components directly to your Astro project
11
+
12
+ ## Installation
13
+
14
+ ```bash
15
+ npm install -g @bearnie/mcp
16
+ ```
17
+
18
+ Or use npx:
19
+
20
+ ```bash
21
+ npx @bearnie/mcp
22
+ ```
23
+
24
+ ## Configuration
25
+
26
+ ### VS Code (GitHub Copilot)
27
+
28
+ Add to your VS Code settings or `.vscode/mcp.json`:
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "bearnie": {
34
+ "command": "npx",
35
+ "args": ["@bearnie/mcp"]
36
+ }
37
+ }
38
+ }
39
+ ```
40
+
41
+ ### Claude Desktop
42
+
43
+ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
44
+
45
+ ```json
46
+ {
47
+ "mcpServers": {
48
+ "bearnie": {
49
+ "command": "npx",
50
+ "args": ["@bearnie/mcp"]
51
+ }
52
+ }
53
+ }
54
+ ```
55
+
56
+ ### Cursor
57
+
58
+ Add to your Cursor MCP settings:
59
+
60
+ ```json
61
+ {
62
+ "mcpServers": {
63
+ "bearnie": {
64
+ "command": "npx",
65
+ "args": ["@bearnie/mcp"]
66
+ }
67
+ }
68
+ }
69
+ ```
70
+
71
+ ## Available Tools
72
+
73
+ ### `list_components`
74
+
75
+ Lists all available Bearnie components grouped by category.
76
+
77
+ **Example prompt:** "What Bearnie components are available?"
78
+
79
+ ### `search_components`
80
+
81
+ Search for components by name, description, or category.
82
+
83
+ **Parameters:**
84
+
85
+ - `query` (string): Search term
86
+
87
+ **Example prompt:** "Find Bearnie components for forms"
88
+
89
+ ### `get_component`
90
+
91
+ Get detailed information about a specific component, including its source code.
92
+
93
+ **Parameters:**
94
+
95
+ - `name` (string): Component name (e.g., "button", "accordion")
96
+
97
+ **Example prompt:** "Show me the Bearnie button component"
98
+
99
+ ### `add_component`
100
+
101
+ Add a component to your Astro project. Creates files in `src/components/bearnie/`.
102
+
103
+ **Parameters:**
104
+
105
+ - `name` (string): Component name to add
106
+ - `cwd` (string, optional): Working directory
107
+
108
+ **Example prompt:** "Add the accordion component to my project"
109
+
110
+ ## Environment Variables
111
+
112
+ - `BEARNIE_REGISTRY_URL`: Override the default registry URL (default: `https://bearnie.dev/registry`)
113
+
114
+ ## Development
115
+
116
+ ```bash
117
+ # Install dependencies
118
+ npm install
119
+
120
+ # Build
121
+ npm run build
122
+
123
+ # Development mode (watch)
124
+ npm run dev
125
+ ```
126
+
127
+ ## License
128
+
129
+ MIT
@@ -0,0 +1 @@
1
+ #!/usr/bin/env node