@codebakers/mcp 5.4.1 → 5.4.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.
package/INSTALL.md CHANGED
@@ -1,221 +1,221 @@
1
- # CodeBakers MCP Server - Installation Guide
2
-
3
- ## One-Command Installation
4
-
5
- The easiest way to install CodeBakers MCP Server:
6
-
7
- ```bash
8
- npx @codebakers/mcp install
9
- ```
10
-
11
- That's it! This command will:
12
- - ✓ Locate your Claude Desktop config file automatically
13
- - ✓ Add CodeBakers MCP Server configuration
14
- - ✓ Set the correct path to the server
15
- - ✓ No manual JSON editing required
16
-
17
- **After installation:**
18
- 1. Restart Claude Desktop
19
- 2. CodeBakers tools will be available automatically
20
- 3. Verify: Run `codebakers_get_context` in Claude Desktop
21
-
22
- ---
23
-
24
- ## Other Commands
25
-
26
- ### Check Installation Status
27
- ```bash
28
- npx @codebakers/mcp status
29
- ```
30
-
31
- Shows whether CodeBakers is installed and displays the current configuration.
32
-
33
- ### Uninstall
34
- ```bash
35
- npx @codebakers/mcp uninstall
36
- ```
37
-
38
- Removes CodeBakers MCP Server from Claude Desktop config.
39
-
40
- ### Version
41
- ```bash
42
- npx @codebakers/mcp version
43
- ```
44
-
45
- Shows the current version of CodeBakers MCP Server.
46
-
47
- ### Help
48
- ```bash
49
- npx @codebakers/mcp help
50
- ```
51
-
52
- Displays all available commands.
53
-
54
- ---
55
-
56
- ## Manual Installation (Advanced)
57
-
58
- If you prefer to configure manually:
59
-
60
- ### 1. Install the package
61
- ```bash
62
- npm install -g @codebakers/mcp
63
- ```
64
-
65
- ### 2. Find your Claude Desktop config file
66
-
67
- **Windows:**
68
- ```
69
- %APPDATA%\Claude\claude_desktop_config.json
70
- ```
71
-
72
- **macOS:**
73
- ```
74
- ~/Library/Application Support/Claude/claude_desktop_config.json
75
- ```
76
-
77
- **Linux:**
78
- ```
79
- ~/.config/Claude/claude_desktop_config.json
80
- ```
81
-
82
- ### 3. Add CodeBakers configuration
83
-
84
- Open the config file and add:
85
-
86
- ```json
87
- {
88
- "mcpServers": {
89
- "codebakers": {
90
- "command": "node",
91
- "args": ["/path/to/codebakers-mcp-server/dist/index.js"]
92
- }
93
- }
94
- }
95
- ```
96
-
97
- Replace `/path/to/codebakers-mcp-server/dist/index.js` with the actual path.
98
-
99
- ### 4. Restart Claude Desktop
100
-
101
- ---
102
-
103
- ## Development Installation (Contributors)
104
-
105
- If you're contributing to CodeBakers:
106
-
107
- ### 1. Clone the repository
108
- ```bash
109
- git clone https://github.com/botmakers-ai/codebakers-v2.git
110
- cd codebakers-v2/codebakers-mcp-server
111
- ```
112
-
113
- ### 2. Install dependencies
114
- ```bash
115
- npm install
116
- ```
117
-
118
- ### 3. Build
119
- ```bash
120
- npm run build
121
- ```
122
-
123
- ### 4. Link locally (optional)
124
- ```bash
125
- npm link
126
- ```
127
-
128
- ### 5. Add to Claude Desktop config
129
-
130
- Get the absolute path to `dist/index.js`:
131
- ```bash
132
- # Windows
133
- cd
134
- # macOS/Linux
135
- pwd
136
- ```
137
-
138
- Add to Claude Desktop config:
139
- ```json
140
- {
141
- "mcpServers": {
142
- "codebakers": {
143
- "command": "node",
144
- "args": ["C:/dev/1 - CodeBakers v2/codebakers-mcp-server/dist/index.js"]
145
- }
146
- }
147
- }
148
- ```
149
-
150
- ### 6. Restart Claude Desktop
151
-
152
- ---
153
-
154
- ## Troubleshooting
155
-
156
- ### Command not found: codebakers
157
- You're using the wrong command. Use:
158
- ```bash
159
- npx @codebakers/mcp-server install
160
- ```
161
-
162
- NOT:
163
- ```bash
164
- codebakers install # ❌ Wrong
165
- ```
166
-
167
- ### Claude Desktop config not found
168
- The installer will create the config directory automatically. If it fails:
169
-
170
- 1. Ensure Claude Desktop is installed
171
- 2. Run Claude Desktop at least once
172
- 3. Try manual installation
173
-
174
- ### Tools not appearing in Claude Desktop
175
- 1. Verify installation: `npx @codebakers/mcp-server status`
176
- 2. Restart Claude Desktop completely (quit and relaunch)
177
- 3. Check Claude Desktop logs for MCP connection errors
178
- 4. Ensure Node.js v18+ is installed: `node --version`
179
-
180
- ### Permission errors
181
- On macOS/Linux, you might need to make the CLI executable:
182
- ```bash
183
- chmod +x node_modules/@codebakers/mcp-server/dist/cli.js
184
- ```
185
-
186
- ---
187
-
188
- ## Verification
189
-
190
- After installation, open Claude Desktop and run:
191
-
192
- ```
193
- codebakers_get_context
194
- ```
195
-
196
- You should see:
197
- ```
198
- 🍞 CodeBakers: [project information]
199
- ```
200
-
201
- If you see this, installation was successful!
202
-
203
- ---
204
-
205
- ## Next Steps
206
-
207
- Once installed:
208
-
209
- 1. **New Project:** Run `codebakers_run_interview` to start
210
- 2. **Existing Project:** Run `codebakers_get_context` to load state
211
- 3. **Read Documentation:** Check `V5.1.0-AUTONOMOUS-BUILD-COMPLETE.md` for full feature list
212
-
213
- ---
214
-
215
- ## Support
216
-
217
- **Issues:** https://github.com/botmakers-ai/codebakers-v2/issues
218
-
219
- **Documentation:** See main repository README
220
-
221
- **License:** MIT
1
+ # CodeBakers MCP Server - Installation Guide
2
+
3
+ ## One-Command Installation
4
+
5
+ The easiest way to install CodeBakers MCP Server:
6
+
7
+ ```bash
8
+ npx @codebakers/mcp install
9
+ ```
10
+
11
+ That's it! This command will:
12
+ - ✓ Locate your Claude Desktop config file automatically
13
+ - ✓ Add CodeBakers MCP Server configuration
14
+ - ✓ Set the correct path to the server
15
+ - ✓ No manual JSON editing required
16
+
17
+ **After installation:**
18
+ 1. Restart Claude Desktop
19
+ 2. CodeBakers tools will be available automatically
20
+ 3. Verify: Run `codebakers_get_context` in Claude Desktop
21
+
22
+ ---
23
+
24
+ ## Other Commands
25
+
26
+ ### Check Installation Status
27
+ ```bash
28
+ npx @codebakers/mcp status
29
+ ```
30
+
31
+ Shows whether CodeBakers is installed and displays the current configuration.
32
+
33
+ ### Uninstall
34
+ ```bash
35
+ npx @codebakers/mcp uninstall
36
+ ```
37
+
38
+ Removes CodeBakers MCP Server from Claude Desktop config.
39
+
40
+ ### Version
41
+ ```bash
42
+ npx @codebakers/mcp version
43
+ ```
44
+
45
+ Shows the current version of CodeBakers MCP Server.
46
+
47
+ ### Help
48
+ ```bash
49
+ npx @codebakers/mcp help
50
+ ```
51
+
52
+ Displays all available commands.
53
+
54
+ ---
55
+
56
+ ## Manual Installation (Advanced)
57
+
58
+ If you prefer to configure manually:
59
+
60
+ ### 1. Install the package
61
+ ```bash
62
+ npm install -g @codebakers/mcp
63
+ ```
64
+
65
+ ### 2. Find your Claude Desktop config file
66
+
67
+ **Windows:**
68
+ ```
69
+ %APPDATA%\Claude\claude_desktop_config.json
70
+ ```
71
+
72
+ **macOS:**
73
+ ```
74
+ ~/Library/Application Support/Claude/claude_desktop_config.json
75
+ ```
76
+
77
+ **Linux:**
78
+ ```
79
+ ~/.config/Claude/claude_desktop_config.json
80
+ ```
81
+
82
+ ### 3. Add CodeBakers configuration
83
+
84
+ Open the config file and add:
85
+
86
+ ```json
87
+ {
88
+ "mcpServers": {
89
+ "codebakers": {
90
+ "command": "node",
91
+ "args": ["/path/to/codebakers-mcp-server/dist/index.js"]
92
+ }
93
+ }
94
+ }
95
+ ```
96
+
97
+ Replace `/path/to/codebakers-mcp-server/dist/index.js` with the actual path.
98
+
99
+ ### 4. Restart Claude Desktop
100
+
101
+ ---
102
+
103
+ ## Development Installation (Contributors)
104
+
105
+ If you're contributing to CodeBakers:
106
+
107
+ ### 1. Clone the repository
108
+ ```bash
109
+ git clone https://github.com/botmakers-ai/codebakers-v2.git
110
+ cd codebakers-v2/codebakers-mcp-server
111
+ ```
112
+
113
+ ### 2. Install dependencies
114
+ ```bash
115
+ npm install
116
+ ```
117
+
118
+ ### 3. Build
119
+ ```bash
120
+ npm run build
121
+ ```
122
+
123
+ ### 4. Link locally (optional)
124
+ ```bash
125
+ npm link
126
+ ```
127
+
128
+ ### 5. Add to Claude Desktop config
129
+
130
+ Get the absolute path to `dist/index.js`:
131
+ ```bash
132
+ # Windows
133
+ cd
134
+ # macOS/Linux
135
+ pwd
136
+ ```
137
+
138
+ Add to Claude Desktop config:
139
+ ```json
140
+ {
141
+ "mcpServers": {
142
+ "codebakers": {
143
+ "command": "node",
144
+ "args": ["C:/dev/1 - CodeBakers v2/codebakers-mcp-server/dist/index.js"]
145
+ }
146
+ }
147
+ }
148
+ ```
149
+
150
+ ### 6. Restart Claude Desktop
151
+
152
+ ---
153
+
154
+ ## Troubleshooting
155
+
156
+ ### Command not found: codebakers
157
+ You're using the wrong command. Use:
158
+ ```bash
159
+ npx @codebakers/mcp-server install
160
+ ```
161
+
162
+ NOT:
163
+ ```bash
164
+ codebakers install # ❌ Wrong
165
+ ```
166
+
167
+ ### Claude Desktop config not found
168
+ The installer will create the config directory automatically. If it fails:
169
+
170
+ 1. Ensure Claude Desktop is installed
171
+ 2. Run Claude Desktop at least once
172
+ 3. Try manual installation
173
+
174
+ ### Tools not appearing in Claude Desktop
175
+ 1. Verify installation: `npx @codebakers/mcp-server status`
176
+ 2. Restart Claude Desktop completely (quit and relaunch)
177
+ 3. Check Claude Desktop logs for MCP connection errors
178
+ 4. Ensure Node.js v18+ is installed: `node --version`
179
+
180
+ ### Permission errors
181
+ On macOS/Linux, you might need to make the CLI executable:
182
+ ```bash
183
+ chmod +x node_modules/@codebakers/mcp-server/dist/cli.js
184
+ ```
185
+
186
+ ---
187
+
188
+ ## Verification
189
+
190
+ After installation, open Claude Desktop and run:
191
+
192
+ ```
193
+ codebakers_get_context
194
+ ```
195
+
196
+ You should see:
197
+ ```
198
+ 🍞 CodeBakers: [project information]
199
+ ```
200
+
201
+ If you see this, installation was successful!
202
+
203
+ ---
204
+
205
+ ## Next Steps
206
+
207
+ Once installed:
208
+
209
+ 1. **New Project:** Run `codebakers_run_interview` to start
210
+ 2. **Existing Project:** Run `codebakers_get_context` to load state
211
+ 3. **Read Documentation:** Check `V5.1.0-AUTONOMOUS-BUILD-COMPLETE.md` for full feature list
212
+
213
+ ---
214
+
215
+ ## Support
216
+
217
+ **Issues:** https://github.com/botmakers-ai/codebakers-v2/issues
218
+
219
+ **Documentation:** See main repository README
220
+
221
+ **License:** MIT
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 BotMakers Inc.
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 BotMakers Inc.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.