@neural-tools/cli 0.1.5 → 0.1.7
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/LICENSE.md +21 -80
- package/README.md +331 -0
- package/dist/cli.js +47 -18
- package/dist/cli.mjs +47 -18
- package/dist/index.d.mts +21 -1
- package/dist/index.d.ts +21 -1
- package/dist/index.js +47 -18
- package/dist/index.mjs +43 -14
- package/package.json +2 -2
package/LICENSE.md
CHANGED
|
@@ -1,80 +1,21 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 Luke Amy
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
### 2. Pro/Enterprise License (Proprietary)
|
|
24
|
-
|
|
25
|
-
The following features require a valid Pro or Enterprise license:
|
|
26
|
-
|
|
27
|
-
**Pro Features:**
|
|
28
|
-
- Vector database integration
|
|
29
|
-
- Semantic caching
|
|
30
|
-
- Fine-tuning workflows
|
|
31
|
-
- Cloud deployment templates (AWS/GCP)
|
|
32
|
-
- Premium templates and examples
|
|
33
|
-
- GitHub automation features
|
|
34
|
-
|
|
35
|
-
**Enterprise Features:**
|
|
36
|
-
- White-label support
|
|
37
|
-
- Custom integrations
|
|
38
|
-
- Priority support
|
|
39
|
-
- SLA guarantees
|
|
40
|
-
- Team collaboration features
|
|
41
|
-
|
|
42
|
-
These features are proprietary and may not be used without a valid license key purchased from neural-tools.dev.
|
|
43
|
-
|
|
44
|
-
### License Terms
|
|
45
|
-
|
|
46
|
-
1. **Free Tier**: You may use the free tier features for any purpose, including commercial use, under the MIT License terms.
|
|
47
|
-
|
|
48
|
-
2. **Pro/Enterprise**: You must purchase a license to access Pro or Enterprise features. Each license is:
|
|
49
|
-
- Per-user for individual licenses
|
|
50
|
-
- Per-organization for team/enterprise licenses
|
|
51
|
-
- Non-transferable without written consent
|
|
52
|
-
- Subject to the terms at neural-tools.dev/terms
|
|
53
|
-
|
|
54
|
-
3. **Source Code**: This repository is private. You may not:
|
|
55
|
-
- Redistribute the source code
|
|
56
|
-
- Create derivative works for redistribution
|
|
57
|
-
- Reverse engineer Pro/Enterprise features
|
|
58
|
-
- Remove or circumvent license checks
|
|
59
|
-
|
|
60
|
-
4. **Support**: Support is provided based on your license tier:
|
|
61
|
-
- Free: Community support only
|
|
62
|
-
- Pro: Email support (48-hour response)
|
|
63
|
-
- Enterprise: Priority support with SLA
|
|
64
|
-
|
|
65
|
-
### Warranty Disclaimer
|
|
66
|
-
|
|
67
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
68
|
-
|
|
69
|
-
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
70
|
-
|
|
71
|
-
### Contact
|
|
72
|
-
|
|
73
|
-
For licensing inquiries:
|
|
74
|
-
- Email: licensing@neural-tools.dev
|
|
75
|
-
- Website: https://neural-tools.dev/pricing
|
|
76
|
-
- Support: support@neural-tools.dev
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
**Last Updated:** January 2025
|
|
1
|
+
# MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Luke Amy
|
|
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.
|
package/README.md
ADDED
|
@@ -0,0 +1,331 @@
|
|
|
1
|
+
# @neural-tools/cli
|
|
2
|
+
|
|
3
|
+
> CLI for Neural Tools - Generate MCPs, Claude commands, skills, plugins, and AI workflows
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@neural-tools/cli)
|
|
6
|
+
[](../../LICENSE.md)
|
|
7
|
+
|
|
8
|
+
The main CLI tool for Neural Tools, providing commands to generate MCP servers, Claude commands, skills, agents, plugins, and deploy AI-powered applications.
|
|
9
|
+
|
|
10
|
+
## Installation
|
|
11
|
+
|
|
12
|
+
### Global Installation (Recommended)
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm install -g @neural-tools/cli
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### Project-specific
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install --save-dev @neural-tools/cli
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Using npx (No installation)
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
npx @neural-tools/cli <command>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Usage
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
neural-tools <command> [options]
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Available Commands
|
|
37
|
+
|
|
38
|
+
### `generate mcp`
|
|
39
|
+
|
|
40
|
+
Generate a FastMCP server with Python templates.
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
neural-tools generate mcp <name> [options]
|
|
44
|
+
|
|
45
|
+
Options:
|
|
46
|
+
-d, --description <desc> Description of the MCP server
|
|
47
|
+
-o, --output <dir> Output directory (default: ./apps)
|
|
48
|
+
--cicd <provider> CI/CD provider (github, harness, none)
|
|
49
|
+
--deployment <platform> Deployment platform (aws, gcp, none)
|
|
50
|
+
--dry-run Preview without creating files
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
**Example:**
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
neural-tools generate mcp github-integration \
|
|
57
|
+
--description "GitHub API integration server" \
|
|
58
|
+
--cicd github \
|
|
59
|
+
--deployment aws
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
This creates:
|
|
63
|
+
- Complete FastMCP server with Python
|
|
64
|
+
- Docker configuration
|
|
65
|
+
- CI/CD workflow files
|
|
66
|
+
- Deployment templates (if specified)
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
### `generate command`
|
|
71
|
+
|
|
72
|
+
Generate a Claude Code slash command.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
neural-tools generate command <name> [options]
|
|
76
|
+
|
|
77
|
+
Options:
|
|
78
|
+
-d, --description <desc> Description of the command
|
|
79
|
+
-o, --output <dir> Output directory (default: ./claude/commands)
|
|
80
|
+
--args <arguments...> Command arguments
|
|
81
|
+
--tools <tools...> Allowed tools for Claude
|
|
82
|
+
--global Install globally to ~/.claude/commands
|
|
83
|
+
--dry-run Preview without creating files
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
**Example:**
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
neural-tools generate command search-docs \
|
|
90
|
+
--description "Search project documentation" \
|
|
91
|
+
--args query \
|
|
92
|
+
--tools "Read" "Grep" "Bash"
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
This creates a slash command that can be used in Claude Code as `/search-docs <query>`.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
### `generate agent`
|
|
100
|
+
|
|
101
|
+
Generate a specialized Claude agent.
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
neural-tools generate agent <name> [options]
|
|
105
|
+
|
|
106
|
+
Options:
|
|
107
|
+
-d, --description <desc> Description of the agent
|
|
108
|
+
-o, --output <dir> Output directory (default: ./claude/agents)
|
|
109
|
+
--model <model> Model to use (sonnet, opus, haiku)
|
|
110
|
+
--tools <tools...> Available tools
|
|
111
|
+
--global Install globally to ~/.claude/agents
|
|
112
|
+
--dry-run Preview without creating files
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
**Example:**
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
neural-tools generate agent code-reviewer \
|
|
119
|
+
--description "Automated code review agent" \
|
|
120
|
+
--model opus \
|
|
121
|
+
--tools "Read" "Grep" "Edit"
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
### `generate skill`
|
|
127
|
+
|
|
128
|
+
Generate a Claude Code skill (`SKILL.md`) for local/global use or inside a plugin.
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
neural-tools generate skill <name> [options]
|
|
132
|
+
|
|
133
|
+
Options:
|
|
134
|
+
-d, --description <desc> Description of the skill
|
|
135
|
+
-o, --output <dir> Output directory (default: ./claude/skills)
|
|
136
|
+
--plugin <dir> Create skill in <dir>/skills/<name>
|
|
137
|
+
--references Create references/ scaffold
|
|
138
|
+
--global Install globally to ~/.claude/skills
|
|
139
|
+
--dry-run Preview without creating files
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**Example:**
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
neural-tools generate skill api-review \
|
|
146
|
+
--description "Review API design and docs for consistency" \
|
|
147
|
+
--references
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
### `generate plugin`
|
|
153
|
+
|
|
154
|
+
Generate a Claude Code plugin scaffold with `.claude-plugin/plugin.json`.
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
neural-tools generate plugin <name> [options]
|
|
158
|
+
|
|
159
|
+
Options:
|
|
160
|
+
-d, --description <desc> Description of the plugin
|
|
161
|
+
-o, --output <dir> Output directory (default: ./claude/plugins)
|
|
162
|
+
--version <version> Plugin version (default: 0.1.0)
|
|
163
|
+
--author <author> Plugin author
|
|
164
|
+
--with-skill <name> Create a starter skill in the plugin
|
|
165
|
+
--dry-run Preview without creating files
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**Example:**
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
neural-tools generate plugin engineering-workflows \
|
|
172
|
+
--description "Internal engineering workflows for Claude Code" \
|
|
173
|
+
--author "ACME Inc." \
|
|
174
|
+
--with-skill bug-triage
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
### `deploy`
|
|
180
|
+
|
|
181
|
+
Deploy an MCP server to AWS or GCP.
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
neural-tools deploy <name> [options]
|
|
185
|
+
|
|
186
|
+
Options:
|
|
187
|
+
-p, --platform <platform> Deployment platform (aws, gcp)
|
|
188
|
+
--region <region> Cloud region
|
|
189
|
+
--env <env> Environment (dev, staging, prod)
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
**Example:**
|
|
193
|
+
|
|
194
|
+
```bash
|
|
195
|
+
neural-tools deploy github-integration \
|
|
196
|
+
--platform aws \
|
|
197
|
+
--region us-east-1 \
|
|
198
|
+
--env production
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
### `login`
|
|
204
|
+
|
|
205
|
+
Manage your Neural Tools license (optional).
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
neural-tools login [options]
|
|
209
|
+
|
|
210
|
+
Options:
|
|
211
|
+
--key <key> License key
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
**Note:** All features are free and available without a license.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
### `status`
|
|
219
|
+
|
|
220
|
+
View current status and available features.
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
neural-tools status
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
Shows:
|
|
227
|
+
- License information (if configured)
|
|
228
|
+
- Available features (all features are enabled)
|
|
229
|
+
- Quick start commands
|
|
230
|
+
|
|
231
|
+
## Project Structure
|
|
232
|
+
|
|
233
|
+
When you use the CLI, it creates organized project structures:
|
|
234
|
+
|
|
235
|
+
```
|
|
236
|
+
my-project/
|
|
237
|
+
├── apps/ # Generated MCP servers
|
|
238
|
+
│ └── mcp-github/
|
|
239
|
+
│ ├── server.py
|
|
240
|
+
│ ├── Dockerfile
|
|
241
|
+
│ └── requirements.txt
|
|
242
|
+
├── claude/
|
|
243
|
+
│ ├── commands/ # Slash commands
|
|
244
|
+
│ │ └── search-docs.md
|
|
245
|
+
│ ├── skills/ # Standalone Claude skills
|
|
246
|
+
│ │ └── api-review/SKILL.md
|
|
247
|
+
│ └── agents/ # Specialized agents
|
|
248
|
+
│ └── code-reviewer.md
|
|
249
|
+
│ └── plugins/ # Claude plugins
|
|
250
|
+
│ └── engineering-workflows/
|
|
251
|
+
│ ├── .claude-plugin/plugin.json
|
|
252
|
+
│ └── skills/
|
|
253
|
+
│ └── bug-triage/SKILL.md
|
|
254
|
+
└── package.json
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
## Configuration
|
|
258
|
+
|
|
259
|
+
The CLI reads configuration from:
|
|
260
|
+
- `package.json` (workspace settings)
|
|
261
|
+
- `.env` (environment variables)
|
|
262
|
+
- `~/.ai-toolkit/` (user settings)
|
|
263
|
+
|
|
264
|
+
## Development
|
|
265
|
+
|
|
266
|
+
```bash
|
|
267
|
+
# Clone the repository
|
|
268
|
+
git clone https://github.com/MacLeanLuke/neural-tools.git
|
|
269
|
+
cd neural-tools/packages/cli
|
|
270
|
+
|
|
271
|
+
# Install dependencies
|
|
272
|
+
pnpm install
|
|
273
|
+
|
|
274
|
+
# Build
|
|
275
|
+
pnpm build
|
|
276
|
+
|
|
277
|
+
# Run locally
|
|
278
|
+
node dist/cli.js --help
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
## Examples
|
|
282
|
+
|
|
283
|
+
### Create a GitHub MCP Server
|
|
284
|
+
|
|
285
|
+
```bash
|
|
286
|
+
neural-tools generate mcp github \
|
|
287
|
+
--description "GitHub API integration" \
|
|
288
|
+
--cicd github \
|
|
289
|
+
--deployment aws
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
### Create a Knowledge Base Search Command
|
|
293
|
+
|
|
294
|
+
```bash
|
|
295
|
+
neural-tools generate command search-kb \
|
|
296
|
+
--description "Search vector database" \
|
|
297
|
+
--args query \
|
|
298
|
+
--tools "Read" "Bash"
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
### Deploy to AWS
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
neural-tools deploy github \
|
|
305
|
+
--platform aws \
|
|
306
|
+
--region us-east-1 \
|
|
307
|
+
--env prod
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
## Dependencies
|
|
311
|
+
|
|
312
|
+
- [@neural-tools/core](../core) - Core utilities and types
|
|
313
|
+
- commander - CLI framework
|
|
314
|
+
- inquirer - Interactive prompts
|
|
315
|
+
- execa - Process execution
|
|
316
|
+
- fs-extra - Enhanced file system operations
|
|
317
|
+
|
|
318
|
+
## Contributing
|
|
319
|
+
|
|
320
|
+
Contributions are welcome! See the [main repository](https://github.com/MacLeanLuke/neural-tools) for guidelines.
|
|
321
|
+
|
|
322
|
+
## License
|
|
323
|
+
|
|
324
|
+
MIT - See [LICENSE.md](../../LICENSE.md) for details.
|
|
325
|
+
|
|
326
|
+
## Links
|
|
327
|
+
|
|
328
|
+
- [Documentation](https://neural-tools.com/docs/cli.html)
|
|
329
|
+
- [GitHub](https://github.com/MacLeanLuke/neural-tools)
|
|
330
|
+
- [npm](https://www.npmjs.com/package/@neural-tools/cli)
|
|
331
|
+
- [Issues](https://github.com/MacLeanLuke/neural-tools/issues)
|
package/dist/cli.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
"use strict";var
|
|
2
|
+
"use strict";var ne=Object.create;var L=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var oe=Object.getOwnPropertyNames;var se=Object.getPrototypeOf,ae=Object.prototype.hasOwnProperty;var le=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of oe(t))!ae.call(e,r)&&r!==n&&L(e,r,{get:()=>t[r],enumerable:!(i=re(t,r))||i.enumerable});return e};var l=(e,t,n)=>(n=e!=null?ne(se(e)):{},le(t||!e||!e.__esModule?L(n,"default",{value:e,enumerable:!0}):n,e));var te=require("commander"),ie=require("@neural-tools/core");var f=l(require("path")),m=l(require("fs-extra")),g=require("@neural-tools/core"),j=l(require("inquirer"));async function N(e,t){g.logger.header(`Generating MCP: ${e}`),t.deployment!=="none"&&await(0,g.requireFeature)("cloud-deployment","Cloud Deployment");let n=t.description;n||(n=(await j.default.prompt([{type:"input",name:"description",message:"Description of your MCP:",default:`${e} MCP server`}])).description);let i=f.default.resolve(t.output||"./apps",e);if(t.dryRun){g.logger.info("Dry run mode - no files will be created"),g.logger.section("Configuration",[`Name: ${e}`,`Description: ${n}`,`Output: ${i}`,`Template: ${t.fastmcp?"FastMCP":"Standard"}`,`CI/CD: ${t.cicd}`,`Deployment: ${t.deployment}`]);return}if(await m.default.pathExists(i)){let{overwrite:r}=await j.default.prompt([{type:"confirm",name:"overwrite",message:`Directory ${i} already exists. Overwrite?`,default:!1}]);if(!r){g.logger.warn("Cancelled");return}await m.default.remove(i)}g.logger.startSpinner("Creating MCP structure...");try{await m.default.ensureDir(i);let r=`[project]
|
|
3
3
|
name = "mcp-${e}"
|
|
4
4
|
version = "0.1.0"
|
|
5
|
-
description = "${
|
|
5
|
+
description = "${n}"
|
|
6
6
|
requires-python = ">=3.10"
|
|
7
7
|
dependencies = [
|
|
8
8
|
"fastmcp>=2.2.0",
|
|
@@ -24,10 +24,10 @@ line-length = 100
|
|
|
24
24
|
|
|
25
25
|
[tool.ruff]
|
|
26
26
|
line-length = 100
|
|
27
|
-
`;await
|
|
27
|
+
`;await m.default.writeFile(f.default.join(i,"pyproject.toml"),r,"utf-8");let o=`"""
|
|
28
28
|
${e} MCP Server
|
|
29
29
|
|
|
30
|
-
${
|
|
30
|
+
${n}
|
|
31
31
|
"""
|
|
32
32
|
from fastmcp import FastMCP
|
|
33
33
|
|
|
@@ -83,9 +83,9 @@ def brainstorm_topic(topic: str) -> str:
|
|
|
83
83
|
|
|
84
84
|
if __name__ == "__main__":
|
|
85
85
|
mcp.run()
|
|
86
|
-
`;await
|
|
86
|
+
`;await m.default.writeFile(f.default.join(i,"server.py"),o,"utf-8");let s=`# ${e} MCP Server
|
|
87
87
|
|
|
88
|
-
${
|
|
88
|
+
${n}
|
|
89
89
|
|
|
90
90
|
## Quick Start with Docker
|
|
91
91
|
|
|
@@ -190,7 +190,7 @@ ruff check .
|
|
|
190
190
|
## License
|
|
191
191
|
|
|
192
192
|
MIT
|
|
193
|
-
`;await
|
|
193
|
+
`;await m.default.writeFile(f.default.join(i,"README.md"),s,"utf-8"),await m.default.writeFile(f.default.join(i,"Dockerfile"),`FROM python:3.11-slim
|
|
194
194
|
|
|
195
195
|
WORKDIR /app
|
|
196
196
|
|
|
@@ -206,7 +206,7 @@ RUN uv pip install --system --no-cache .
|
|
|
206
206
|
|
|
207
207
|
# Run the MCP server
|
|
208
208
|
CMD ["python", "server.py"]
|
|
209
|
-
`,"utf-8");let
|
|
209
|
+
`,"utf-8");let p=`version: '3.8'
|
|
210
210
|
|
|
211
211
|
services:
|
|
212
212
|
mcp:
|
|
@@ -219,7 +219,7 @@ services:
|
|
|
219
219
|
- .:/app
|
|
220
220
|
environment:
|
|
221
221
|
- PYTHONUNBUFFERED=1
|
|
222
|
-
`;if(await
|
|
222
|
+
`;if(await m.default.writeFile(f.default.join(i,"docker-compose.yml"),p,"utf-8"),await m.default.writeFile(f.default.join(i,".dockerignore"),`__pycache__
|
|
223
223
|
*.pyc
|
|
224
224
|
*.pyo
|
|
225
225
|
*.pyd
|
|
@@ -236,7 +236,7 @@ venv
|
|
|
236
236
|
.git
|
|
237
237
|
.github
|
|
238
238
|
README.md
|
|
239
|
-
`,"utf-8"),t.cicd==="github"){await
|
|
239
|
+
`,"utf-8"),t.cicd==="github"){await m.default.ensureDir(f.default.join(i,".github","workflows"));let v=`name: Deploy MCP
|
|
240
240
|
|
|
241
241
|
on:
|
|
242
242
|
push:
|
|
@@ -320,22 +320,22 @@ jobs:
|
|
|
320
320
|
run: |
|
|
321
321
|
gcloud builds submit --tag gcr.io/\${{ secrets.GCP_PROJECT_ID }}/mcp-${e}:latest
|
|
322
322
|
`:""}
|
|
323
|
-
`;await
|
|
323
|
+
`;await m.default.writeFile(f.default.join(i,".github","workflows","deploy.yml"),v,"utf-8")}g.logger.succeedSpinner("MCP created successfully!"),g.logger.section("Next steps",[`1. cd ${i}`,"2. docker-compose up # Start with Docker","","Or for local development:","2. uv pip install -e .","3. python server.py","","Or use MCP Inspector:","2. uv pip install -e .","3. fastmcp dev server.py","","Add to Claude Code settings to use this MCP"]),g.logger.success(`\u2728 MCP "${e}" ready to use!`)}catch(r){throw g.logger.failSpinner("Failed to create MCP"),r}}var O=l(require("path")),Y=l(require("os")),G=l(require("fs-extra")),y=require("@neural-tools/core"),I=l(require("inquirer"));async function q(e,t){y.logger.header(`Generating Claude Command: /${e}`);let n=t.description;n||(n=(await I.default.prompt([{type:"input",name:"description",message:"Description of your command:",default:`Execute ${e}`}])).description);let i;t.global?i=O.default.join(Y.default.homedir(),".claude","commands"):i=O.default.resolve(t.output||"./claude/commands");let r=O.default.join(i,`${e}.md`);if(t.dryRun){y.logger.info("Dry run mode - no files will be created"),y.logger.section("Configuration",[`Name: /${e}`,`Description: ${n}`,`Output: ${r}`,`Arguments: ${t.args?.join(", ")||"none"}`,`Allowed Tools: ${t.tools?.join(", ")||"all"}`,`Global: ${t.global?"Yes":"No"}`]);return}if(await G.default.pathExists(r)){let{overwrite:o}=await I.default.prompt([{type:"confirm",name:"overwrite",message:`Command /${e} already exists. Overwrite?`,default:!1}]);if(!o){y.logger.warn("Cancelled");return}}y.logger.startSpinner("Creating Claude command...");try{await G.default.ensureDir(i);let o=["---"];t.args&&t.args.length>0&&o.push(`argument-hint: ${t.args.join(" ")}`),o.push(`description: ${n}`),t.tools&&t.tools.length>0&&(o.push("allowed-tools:"),t.tools.forEach(v=>{o.push(` - ${v}`)})),o.push("---"),o.push("");let s=t.args||[],u=s.map((v,E)=>`$${E+1}`).join(" "),p=s.length>0?`
|
|
324
324
|
|
|
325
325
|
Arguments:
|
|
326
|
-
${
|
|
327
|
-
`)}`:"",
|
|
326
|
+
${s.map((v,E)=>`- $${E+1}: ${v}`).join(`
|
|
327
|
+
`)}`:"",R=`${o.join(`
|
|
328
328
|
`)}# ${e} Command
|
|
329
329
|
|
|
330
|
-
Execute the ${e} operation${
|
|
330
|
+
Execute the ${e} operation${p?":"+p:"."}
|
|
331
331
|
|
|
332
|
-
${
|
|
332
|
+
${u?`Using arguments: ${u}`:""}
|
|
333
333
|
|
|
334
334
|
Please proceed with the ${e} operation.
|
|
335
|
-
`;await
|
|
335
|
+
`;await G.default.writeFile(r,R,"utf-8"),y.logger.succeedSpinner("Claude command created successfully!"),y.logger.section("Next steps",[t.global?`Command /${e} is now available globally in Claude Code`:`Add the command to your project by copying ${r}`,"","Usage:",s.length>0?` /${e} ${s.join(" ")}`:` /${e}`]),y.logger.success(`\u2728 Command "/${e}" ready to use!`)}catch(o){throw y.logger.failSpinner("Failed to create command"),o}}var M=l(require("path")),U=l(require("os")),_=l(require("fs-extra")),h=require("@neural-tools/core"),F=l(require("inquirer"));async function W(e,t){h.logger.header(`Generating Claude Agent: ${e}`);let n=t.description;n||(n=(await F.default.prompt([{type:"input",name:"description",message:"Description of your agent:",default:`${e} specialized agent`}])).description);let i;t.global?i=M.default.join(U.default.homedir(),".claude","agents"):i=M.default.resolve(t.output||"./claude/agents");let r=M.default.join(i,`${e}.md`),o=t.model||"sonnet";if(t.dryRun){h.logger.info("Dry run mode - no files will be created"),h.logger.section("Configuration",[`Name: ${e}`,`Description: ${n}`,`Output: ${r}`,`Model: ${o}`,`Tools: ${t.tools?.join(", ")||"all"}`,`Global: ${t.global?"Yes":"No"}`]);return}if(await _.default.pathExists(r)){let{overwrite:s}=await F.default.prompt([{type:"confirm",name:"overwrite",message:`Agent ${e} already exists. Overwrite?`,default:!1}]);if(!s){h.logger.warn("Cancelled");return}}h.logger.startSpinner("Creating Claude agent...");try{await _.default.ensureDir(i);let s=["---"];s.push(`model: claude-${o}-4-5`),t.tools&&t.tools.length>0&&(s.push("tools:"),t.tools.forEach(p=>{s.push(` - ${p}`)})),s.push("---"),s.push("");let u=`${s.join(`
|
|
336
336
|
`)}# ${e} Agent
|
|
337
337
|
|
|
338
|
-
${
|
|
338
|
+
${n}
|
|
339
339
|
|
|
340
340
|
## Role
|
|
341
341
|
|
|
@@ -361,4 +361,33 @@ Provide clear, structured responses that:
|
|
|
361
361
|
- [Output requirement 3]
|
|
362
362
|
|
|
363
363
|
Focus on ${e} and deliver actionable results.
|
|
364
|
-
`;await
|
|
364
|
+
`;await _.default.writeFile(r,u,"utf-8"),h.logger.succeedSpinner("Claude agent created successfully!"),h.logger.section("Next steps",[t.global?`Agent ${e} is now available globally in Claude Code`:`Add the agent to your project by copying ${r}`,"","Customize the agent by editing:",` ${r}`,"","Use the agent via the Task tool in Claude Code"]),h.logger.success(`\u2728 Agent "${e}" ready to use!`)}catch(s){throw h.logger.failSpinner("Failed to create agent"),s}}var k=l(require("path")),K=l(require("os")),D=l(require("fs-extra")),T=l(require("inquirer")),w=require("@neural-tools/core");async function B(e,t){w.logger.header(`Generating Claude Skill: ${e}`);let n=t.description;n||(n=(await T.default.prompt([{type:"input",name:"description",message:"Description of your skill:",default:`${e} skill for Claude Code`}])).description);let i=ce(t),r=k.default.join(i,e),o=k.default.join(r,"SKILL.md"),s=k.default.join(r,"references");if(t.dryRun){w.logger.info("Dry run mode - no files will be created"),w.logger.section("Configuration",[`Name: ${e}`,`Description: ${n}`,`Output: ${o}`,`Plugin: ${t.plugin||"none"}`,`References: ${t.references?"Yes":"No"}`,`Global: ${t.global?"Yes":"No"}`]);return}if(await D.default.pathExists(o)){let{overwrite:u}=await T.default.prompt([{type:"confirm",name:"overwrite",message:`Skill ${e} already exists. Overwrite?`,default:!1}]);if(!u){w.logger.warn("Cancelled");return}}w.logger.startSpinner("Creating Claude skill...");try{await D.default.ensureDir(r),t.references&&await D.default.ensureDir(s);let u=`---
|
|
365
|
+
name: ${e}
|
|
366
|
+
description: ${n}
|
|
367
|
+
---
|
|
368
|
+
|
|
369
|
+
# ${e}
|
|
370
|
+
|
|
371
|
+
${n}
|
|
372
|
+
|
|
373
|
+
## When to use this skill
|
|
374
|
+
|
|
375
|
+
Use this skill when the request matches ${e} workflows.
|
|
376
|
+
|
|
377
|
+
## Workflow
|
|
378
|
+
|
|
379
|
+
1. Gather the relevant project context.
|
|
380
|
+
2. Apply ${e} specific checks and implementation steps.
|
|
381
|
+
3. Return concrete output and next actions.
|
|
382
|
+
`;if(await D.default.writeFile(o,u,"utf-8"),t.references){let p=`# References
|
|
383
|
+
|
|
384
|
+
Store focused reference material for the ${e} skill in this folder.
|
|
385
|
+
`;await D.default.writeFile(k.default.join(s,"README.md"),p,"utf-8")}w.logger.succeedSpinner("Claude skill created successfully!"),w.logger.section("Next steps",[`Edit the skill definition: ${o}`,t.references?`Add reference docs in: ${s}`:"Use --references to scaffold a references folder"]),w.logger.success(`\u2728 Skill "${e}" ready to use!`)}catch(u){throw w.logger.failSpinner("Failed to create skill"),u}}function ce(e){return e.plugin?k.default.resolve(e.plugin,"skills"):e.global?k.default.join(K.default.homedir(),".claude","skills"):k.default.resolve(e.output||"./claude/skills")}var b=l(require("path")),P=l(require("fs-extra")),x=l(require("inquirer")),C=require("@neural-tools/core");async function z(e,t){C.logger.header(`Generating Claude Plugin: ${e}`);let n=t.description;n||(n=(await x.default.prompt([{type:"input",name:"description",message:"Description of your plugin:",default:`${e} Claude Code plugin`}])).description);let i=n||`${e} Claude Code plugin`,r=b.default.resolve(t.output||"./claude/plugins",e),o=b.default.join(r,".claude-plugin"),s=b.default.join(o,"plugin.json"),u=b.default.join(r,"skills");if(t.dryRun){C.logger.info("Dry run mode - no files will be created"),C.logger.section("Configuration",[`Name: ${e}`,`Description: ${i}`,`Output: ${r}`,`Plugin config: ${s}`,`Version: ${t.version||"0.1.0"}`,`Author: ${t.author||"none"}`,`Starter skill: ${t.withSkill||"none"}`]);return}if(await P.default.pathExists(s)){let{overwrite:p}=await x.default.prompt([{type:"confirm",name:"overwrite",message:`Plugin ${e} already exists. Overwrite config?`,default:!1}]);if(!p){C.logger.warn("Cancelled");return}}C.logger.startSpinner("Creating Claude plugin...");try{await P.default.ensureDir(o),await P.default.ensureDir(u);let p={name:e,version:t.version||"0.1.0",description:i};if(t.author&&(p.author=t.author),await P.default.writeJSON(s,p,{spaces:2}),t.withSkill){let R=b.default.join(u,t.withSkill),v=b.default.join(R,"SKILL.md");await P.default.ensureDir(R);let E=`---
|
|
386
|
+
name: ${t.withSkill}
|
|
387
|
+
description: Starter skill for ${e}
|
|
388
|
+
---
|
|
389
|
+
|
|
390
|
+
# ${t.withSkill}
|
|
391
|
+
|
|
392
|
+
Starter skill scaffolded with the plugin.
|
|
393
|
+
`;await P.default.writeFile(v,E,"utf-8")}C.logger.succeedSpinner("Claude plugin created successfully!"),C.logger.section("Next steps",[`Review plugin manifest: ${s}`,t.withSkill?`Customize skill: ${b.default.join(u,t.withSkill,"SKILL.md")}`:"Use `generate skill <name> --plugin <plugin-dir>` to add skills",`Install with Claude Code using the plugin path: ${r}`]),C.logger.success(`\u2728 Plugin "${e}" ready to use!`)}catch(p){throw C.logger.failSpinner("Failed to create plugin"),p}}var a=require("@neural-tools/core"),V=require("execa"),H=l(require("path")),J=l(require("fs-extra"));async function Q(e,t){a.logger.header(`Deploying MCP: ${e}`),await(0,a.requireFeature)("cloud-deployment","Cloud Deployment");let n=t.platform||"aws",i=t.env||"dev";a.logger.info(`Platform: ${n}`),a.logger.info(`Environment: ${i}`);let r=H.default.resolve("./apps",e);if(!await J.default.pathExists(r))throw new Error(`MCP "${e}" not found at ${r}`);a.logger.startSpinner("Building MCP...");try{await(0,V.execa)("npm",["run","build"],{cwd:r,stdio:"pipe"}),a.logger.succeedSpinner("MCP built successfully"),n==="aws"?await ue(e,r,t):n==="gcp"&&await pe(e,r,t),a.logger.success(`\u2728 MCP "${e}" deployed successfully!`)}catch(o){throw a.logger.failSpinner("Deployment failed"),o}}async function ue(e,t,n){a.logger.startSpinner("Deploying to AWS Lambda..."),a.logger.updateSpinner("Packaging Lambda function..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.updateSpinner("Uploading to S3..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.updateSpinner("Creating/updating Lambda function..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.succeedSpinner("Deployed to AWS Lambda"),a.logger.section("Deployment Info",[`Function: ${e}-${n.env}`,`Region: ${n.region||"us-east-1"}`,`Environment: ${n.env}`,"","Configure in Claude Code:",JSON.stringify({mcpServers:{[e]:{command:"aws",args:["lambda","invoke","--function-name",`${e}-${n.env}`,"--payload","stdin","--output","stdout"]}}},null,2)])}async function pe(e,t,n){a.logger.startSpinner("Deploying to Google Cloud Functions..."),a.logger.updateSpinner("Packaging function..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.updateSpinner("Uploading to Cloud Storage..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.updateSpinner("Deploying Cloud Function..."),await new Promise(i=>setTimeout(i,1e3)),a.logger.succeedSpinner("Deployed to Google Cloud Functions"),a.logger.section("Deployment Info",[`Function: ${e}-${n.env}`,`Region: ${n.region||"us-central1"}`,`Environment: ${n.env}`])}var c=require("@neural-tools/core"),X=l(require("inquirer"));async function Z(e){c.logger.header("AI Toolkit License Management");let t=e.key;if(t||(t=(await X.default.prompt([{type:"input",name:"licenseKey",message:"Enter your license key:",validate:i=>!i||i.trim().length===0?"License key is required":!0}])).licenseKey),!t){c.logger.error("License key is required");return}c.logger.startSpinner("Validating license...");try{let n=t.split("-");if(n.length<2)throw new Error("Invalid license key format");let i=n[0],r=n[1];if(!Object.values(c.LicenseTier).includes(i))throw new Error("Invalid license tier");await c.licenseManager.saveLicense({tier:i,email:r,key:t,features:[]}),c.logger.succeedSpinner("License activated successfully!");let o=await c.licenseManager.loadLicense();c.logger.section("License Details",[`Tier: ${o.tier.toUpperCase()}`,`Email: ${o.email||"N/A"}`,"Status: Active"]);let s=de();c.logger.section("Available Features",s),c.logger.success("\u2728 Ready to build!")}catch(n){c.logger.failSpinner("License validation failed"),c.logger.error(n.message||"Invalid license key"),c.logger.newline(),c.logger.info("All features are available for free - no license required!")}}function de(){return["\u2713 MCP generation","\u2713 Claude commands","\u2713 Claude agents","\u2713 Vector database integration","\u2713 Semantic caching","\u2713 Fine-tuning workflows","\u2713 Cloud deployment (AWS/GCP)","\u2713 GitHub automation","\u2713 All templates"]}var d=require("@neural-tools/core");async function ee(){d.logger.header("AI Toolkit Status");try{let e=await d.licenseManager.loadLicense();d.logger.section("License Information",[`Tier: ${e.tier.toUpperCase()}`,`Email: ${e.email||"N/A"}`,`Status: ${e.expiresAt?me(e.expiresAt):"Active"}`]);let t=[{name:"MCP Generation",key:"mcp-generation"},{name:"Claude Commands",key:"claude-commands"},{name:"Vector Database",key:"vector-db"},{name:"Semantic Cache",key:"semantic-cache"},{name:"Fine-tuning",key:"fine-tuning"},{name:"Cloud Deployment",key:"cloud-deployment"},{name:"GitHub Automation",key:"github-automation"}],n=await Promise.all(t.map(async i=>`${await d.licenseManager.checkFeature(i.key)?"\u2713":"\u2717"} ${i.name}`));d.logger.section("Feature Availability",n),d.logger.newline(),d.logger.section("Quick Start",["Generate an MCP server:"," ai-toolkit generate mcp github","","Generate a Claude command:"," ai-toolkit generate command search-kb","","View all commands:"," ai-toolkit --help"])}catch{d.logger.error("Failed to load license information"),d.logger.newline(),d.logger.info("All features are available - no license required!"),d.logger.info('Run "ai-toolkit --help" to get started')}}function me(e){let t=new Date(e),n=new Date;if(t<n)return"Expired";let i=Math.ceil((t.getTime()-n.getTime())/(1e3*60*60*24));return i<=30?`Active (expires in ${i} days)`:"Active"}var S=new te.Command;S.name("neural-tools").description("Neural Tools - Build MCPs, Claude commands, skills, plugins, and AI workflows").version("0.1.0");var A=S.command("generate").alias("g").description("Generate new components (MCP, command, agent, skill, plugin, etc.)");A.command("mcp").description("Generate a new MCP server").argument("<name>","Name of the MCP server").option("-d, --description <desc>","Description of the MCP").option("-o, --output <dir>","Output directory","./apps").option("--fastmcp","Use FastMCP template",!0).option("--cicd <provider>","CI/CD provider (github, harness, none)","github").option("--deployment <platform>","Deployment platform (aws, gcp, none)","aws").option("--dry-run","Preview without creating files",!1).action(N);A.command("command").description("Generate a new Claude command").argument("<name>","Name of the command (without /)").option("-d, --description <desc>","Description of the command").option("-o, --output <dir>","Output directory","./claude/commands").option("--args <arguments...>","Command arguments").option("--tools <tools...>","Allowed tools").option("--global","Install globally to ~/.claude/commands",!1).option("--dry-run","Preview without creating files",!1).action(q);A.command("agent").description("Generate a new Claude agent").argument("<name>","Name of the agent").option("-d, --description <desc>","Description of the agent").option("-o, --output <dir>","Output directory","./claude/agents").option("--model <model>","Model to use (sonnet, opus, haiku)","sonnet").option("--tools <tools...>","Available tools").option("--global","Install globally to ~/.claude/agents",!1).option("--dry-run","Preview without creating files",!1).action(W);A.command("skill").description("Generate a new Claude skill").argument("<name>","Name of the skill").option("-d, --description <desc>","Description of the skill").option("-o, --output <dir>","Output directory","./claude/skills").option("--plugin <dir>","Write skill into a plugin directory (creates <dir>/skills/<name>)").option("--references","Create a references folder scaffold",!1).option("--global","Install globally to ~/.claude/skills",!1).option("--dry-run","Preview without creating files",!1).action(B);A.command("plugin").description("Generate a new Claude plugin").argument("<name>","Name of the plugin").option("-d, --description <desc>","Description of the plugin").option("-o, --output <dir>","Output directory","./claude/plugins").option("--version <version>","Plugin version","0.1.0").option("--author <author>","Plugin author").option("--with-skill <name>","Create a starter skill inside the plugin").option("--dry-run","Preview without creating files",!1).action(z);S.command("deploy").description("Deploy an MCP server").argument("<name>","Name of the MCP to deploy").option("-p, --platform <platform>","Deployment platform (aws, gcp)","aws").option("--region <region>","AWS/GCP region").option("--env <env>","Environment (dev, staging, prod)","dev").action(Q);S.command("login").description("Authenticate and manage your license").option("--key <key>","License key").action(Z);S.command("status").description("Show license status and available features").action(ee);S.exitOverride();try{S.parse(process.argv)}catch(e){e.code!=="commander.help"&&e.code!=="commander.version"&&(ie.logger.error(e.message||"An unexpected error occurred"),process.exit(1))}
|