@hasna/skills 0.1.32 → 0.1.33
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 +1 -16
- package/bin/index.js +57 -14
- package/bin/mcp.js +57 -13
- package/dist/cli/commands/runtime.d.ts +1 -1
- package/dist/index.js +51 -5
- package/dist/lib/skill-validation.d.ts +2 -0
- package/package.json +1 -1
- package/skills/ad-creative-pack/package.json +4 -7
- package/skills/api-docs-portal/package.json +5 -3
- package/skills/audio/package.json +4 -22
- package/skills/audio-transcript-pack/package.json +3 -2
- package/skills/blog-article/package.json +5 -21
- package/skills/brand-kit/package.json +4 -7
- package/skills/brand-photo-shoot/package.json +3 -2
- package/skills/browse/package.json +4 -33
- package/skills/contract-review-report/package.json +3 -2
- package/skills/customer-feedback-report/package.json +3 -2
- package/skills/deepresearch/package.json +4 -37
- package/skills/domainpurchase/SKILL.md +14 -31
- package/skills/domainpurchase/package.json +3 -8
- package/skills/email-sequence/package.json +4 -7
- package/skills/generate-book-cover/package.json +5 -23
- package/skills/icon-pack/package.json +4 -22
- package/skills/image/package.json +4 -22
- package/skills/invoice-reconciliation/package.json +3 -2
- package/skills/landing-page-pack/package.json +4 -7
- package/skills/logo-design/package.json +4 -2
- package/skills/managemcp/CLAUDE.md +9 -43
- package/skills/managemcp/README.md +12 -198
- package/skills/managemcp/package.json +2 -10
- package/skills/managemcp/tsconfig.json +1 -3
- package/skills/market-research-report/package.json +5 -4
- package/skills/meeting-pack/package.json +3 -2
- package/skills/migration-plan-pack/package.json +3 -2
- package/skills/music/package.json +4 -20
- package/skills/music-album/package.json +3 -2
- package/skills/one-page-website/package.json +3 -2
- package/skills/pdf-read/package.json +5 -23
- package/skills/pdf-to-dataset/package.json +5 -4
- package/skills/pdf-to-markdown/package.json +5 -4
- package/skills/performance-audit-report/package.json +3 -2
- package/skills/photo-album/package.json +4 -2
- package/skills/pitch-deck/package.json +5 -3
- package/skills/playlist-maker/package.json +4 -2
- package/skills/product-mockup/package.json +3 -2
- package/skills/proposal-pack/package.json +5 -4
- package/skills/read-pdf/package.json +4 -29
- package/skills/remove-background/package.json +5 -21
- package/skills/repo-onboarding-report/package.json +3 -2
- package/skills/sdk-generator/package.json +3 -2
- package/skills/security-audit-report/package.json +5 -4
- package/skills/seo-content-pack/package.json +5 -3
- package/skills/short-video-pack/package.json +3 -2
- package/skills/slide-deck-generator/package.json +3 -2
- package/skills/sms/README.md +18 -56
- package/skills/sms/package.json +1 -3
- package/skills/sms/tsconfig.json +1 -2
- package/skills/social-content-calendar/package.json +4 -7
- package/skills/test-suite-generator/package.json +5 -4
- package/skills/transcript/package.json +4 -23
- package/skills/video/package.json +4 -24
- package/skills/video-highlight-pack/package.json +3 -2
- package/skills/voiceover-jingle-pack/package.json +3 -2
- package/skills/webcrawling/package.json +4 -32
- package/skills/domainpurchase/.env.example +0 -7
- package/skills/domainpurchase/src/lib/api-client.ts +0 -571
- package/skills/domainpurchase/src/lib/config.ts +0 -209
- package/skills/domainpurchase/src/lib/installer.ts +0 -165
- package/skills/managemcp/.env.example +0 -16
- package/skills/managemcp/scripts/migrate.ts +0 -57
- package/skills/managemcp/scripts/seed.ts +0 -58
- package/skills/managemcp/src/db/index.ts +0 -37
- package/skills/managemcp/src/lib/api-client.ts +0 -108
- package/skills/managemcp/src/lib/config.ts +0 -34
- package/skills/managemcp/src/lib/installer.ts +0 -140
- package/skills/managemcp/src/lib/service-dir.ts +0 -119
- package/skills/sms/scripts/buy-number.ts +0 -63
- package/skills/sms/scripts/test-send.ts +0 -67
- package/skills/sms/src/server.ts +0 -351
- package/skills/sms/src/sse-server.ts +0 -279
|
@@ -1,40 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "browse",
|
|
3
3
|
"version": "1.0.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "MCP Browse server for AI agents - Browser automation using Browser-Use Cloud API",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
|
|
8
|
-
"
|
|
9
|
-
},
|
|
10
|
-
"scripts": {
|
|
11
|
-
"start": "bun run src/index.ts",
|
|
12
|
-
"dev": "bun run --watch src/index.ts",
|
|
13
|
-
"sse": "bun run src/sse-server.ts",
|
|
14
|
-
"sse:dev": "bun run --watch src/sse-server.ts"
|
|
15
|
-
},
|
|
16
|
-
"keywords": [
|
|
17
|
-
"browser",
|
|
18
|
-
"automation",
|
|
19
|
-
"scraping",
|
|
20
|
-
"web",
|
|
21
|
-
"ai-agent",
|
|
22
|
-
"browser-use",
|
|
23
|
-
"mcp"
|
|
24
|
-
],
|
|
25
|
-
"author": "",
|
|
26
|
-
"dependencies": {
|
|
27
|
-
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
28
|
-
"cors": "^2.8.5",
|
|
29
|
-
"express": "^4.21.0",
|
|
30
|
-
"zod": "^3.23.8"
|
|
31
|
-
},
|
|
32
|
-
"devDependencies": {
|
|
33
|
-
"@types/bun": "latest",
|
|
34
|
-
"@types/cors": "^2.8.17",
|
|
35
|
-
"@types/express": "^4.17.21"
|
|
36
|
-
},
|
|
37
|
-
"peerDependencies": {
|
|
38
|
-
"typescript": "^5.0.0"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
39
10
|
}
|
|
40
11
|
}
|
|
@@ -1,44 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "deepresearch",
|
|
3
3
|
"version": "0.1.3",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Agentic deep research skill using Exa.ai for search and Claude/OpenAI for synthesis",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
|
|
8
|
-
"
|
|
9
|
-
},
|
|
10
|
-
"files": [
|
|
11
|
-
"src",
|
|
12
|
-
"README.md",
|
|
13
|
-
"SKILL.md"
|
|
14
|
-
],
|
|
15
|
-
"publishConfig": {
|
|
16
|
-
"access": "restricted"
|
|
17
|
-
},
|
|
18
|
-
"keywords": [
|
|
19
|
-
"research",
|
|
20
|
-
"ai",
|
|
21
|
-
"exa",
|
|
22
|
-
"claude",
|
|
23
|
-
"openai",
|
|
24
|
-
"rag",
|
|
25
|
-
"deep-research"
|
|
26
|
-
],
|
|
27
|
-
"scripts": {
|
|
28
|
-
"start": "bun run src/index.ts",
|
|
29
|
-
"dev": "bun --watch src/index.ts",
|
|
30
|
-
"typecheck": "tsc --noEmit"
|
|
31
|
-
},
|
|
32
|
-
"dependencies": {
|
|
33
|
-
"@anthropic-ai/sdk": "^0.30.0",
|
|
34
|
-
"chalk": "^5.3.0",
|
|
35
|
-
"commander": "^12.1.0",
|
|
36
|
-
"exa-js": "^1.0.12",
|
|
37
|
-
"openai": "^4.0.0",
|
|
38
|
-
"ora": "^8.0.1"
|
|
39
|
-
},
|
|
40
|
-
"devDependencies": {
|
|
41
|
-
"@types/bun": "latest",
|
|
42
|
-
"typescript": "^5.7.0"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
43
10
|
}
|
|
44
11
|
}
|
|
@@ -1,46 +1,29 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: domainpurchase
|
|
3
|
-
description:
|
|
3
|
+
description: Public contract for domain purchase workflows through hosted or external registrar connectors.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Domain Purchase
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
- Purchase domains through GoDaddy API
|
|
13
|
-
- Manage domain configurations and settings
|
|
14
|
-
- HTTP server mode for API-driven purchases
|
|
15
|
-
- AWS Secrets Manager integration for credential storage
|
|
16
|
-
- Remote server proxy mode for centralized domain management
|
|
8
|
+
This public skill describes domain purchase and management workflows for agents.
|
|
9
|
+
The OSS package intentionally does not ship registrar purchasing logic, remote
|
|
10
|
+
server proxy code, or cloud secret-store integration.
|
|
17
11
|
|
|
18
12
|
## Usage
|
|
19
13
|
|
|
20
14
|
```bash
|
|
21
|
-
|
|
22
|
-
domainpurchase
|
|
23
|
-
|
|
24
|
-
# Start the HTTP server
|
|
25
|
-
bun run start
|
|
26
|
-
|
|
27
|
-
# Development mode with watch
|
|
28
|
-
bun run dev
|
|
15
|
+
skills run domainpurchase --help
|
|
29
16
|
```
|
|
30
17
|
|
|
31
|
-
|
|
18
|
+
For production domain purchase workflows, route execution through a hosted or
|
|
19
|
+
external connector that owns registrar credentials, audit logs, payment
|
|
20
|
+
approval, and account-specific policy.
|
|
32
21
|
|
|
33
|
-
|
|
34
|
-
|----------|-------------|
|
|
35
|
-
| `DOMAIN_API_KEY` | GoDaddy API key |
|
|
36
|
-
| `DOMAIN_API_SECRET` | GoDaddy API secret |
|
|
37
|
-
| `DOMAIN_CUSTOMER_ID` | GoDaddy customer ID |
|
|
38
|
-
| `DOMAIN_API_URL` | API base URL (default: `https://api.godaddy.com`) |
|
|
39
|
-
| `DOMAIN_USE_REMOTE_SERVER` | Use remote server proxy (`true`/`false`) |
|
|
40
|
-
| `DOMAIN_REMOTE_SERVER_URL` | Remote server URL |
|
|
41
|
-
| `DOMAIN_REMOTE_API_KEY` | Remote server API key |
|
|
42
|
-
| `AWS_SECRET_NAME` | AWS Secrets Manager secret name for credentials |
|
|
22
|
+
## Boundary
|
|
43
23
|
|
|
44
|
-
|
|
24
|
+
- Local package: skill metadata, docs, and a CLI stub.
|
|
25
|
+
- Hosted or external connector: registrar API calls, credentials, approvals,
|
|
26
|
+
purchase records, and billing-sensitive workflows.
|
|
45
27
|
|
|
46
|
-
|
|
28
|
+
Provider credentials and cloud secret names must not be stored in this OSS
|
|
29
|
+
skill package.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "domainpurchase",
|
|
3
3
|
"version": "0.1.3",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "Public domain purchase skill contract and local CLI stub",
|
|
6
6
|
"private": true,
|
|
7
7
|
"publishConfig": {
|
|
8
8
|
"registry": "https://registry.npmjs.org",
|
|
@@ -12,8 +12,8 @@
|
|
|
12
12
|
"domainpurchase": "src/index.ts"
|
|
13
13
|
},
|
|
14
14
|
"files": [
|
|
15
|
-
"bin",
|
|
16
15
|
"src",
|
|
16
|
+
"SKILL.md",
|
|
17
17
|
"tsconfig.json"
|
|
18
18
|
],
|
|
19
19
|
"homepage": "https://github.com/hasnaxyz/domainpurchase#readme",
|
|
@@ -21,12 +21,7 @@
|
|
|
21
21
|
"url": "https://github.com/hasnaxyz/domainpurchase/issues"
|
|
22
22
|
},
|
|
23
23
|
"scripts": {
|
|
24
|
-
"
|
|
25
|
-
"start": "bun run src/server/index.ts",
|
|
26
|
-
"cli": "bun run bin/cli.ts"
|
|
27
|
-
},
|
|
28
|
-
"dependencies": {
|
|
29
|
-
"@aws-sdk/client-secrets-manager": "^3.700.0"
|
|
24
|
+
"start": "bun run src/index.ts"
|
|
30
25
|
},
|
|
31
26
|
"devDependencies": {
|
|
32
27
|
"@types/bun": "^1.1.14",
|
|
@@ -1,14 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "email-sequence",
|
|
3
3
|
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Hosted premium email sequence artifact generator",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
"dependencies": {},
|
|
10
|
-
"devDependencies": {
|
|
11
|
-
"@types/bun": "latest",
|
|
12
|
-
"typescript": "^5.7.0"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
13
10
|
}
|
|
14
11
|
}
|
|
@@ -1,29 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "generate-book-cover",
|
|
3
3
|
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Generate Book Cover skill",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"dev": "bun run src/index.ts",
|
|
11
|
-
"build": "bun build src/index.ts --outdir dist --target node",
|
|
12
|
-
"typecheck": "tsc --noEmit"
|
|
13
|
-
},
|
|
14
|
-
"dependencies": {
|
|
15
|
-
"openai": "^4.77.0"
|
|
16
|
-
},
|
|
17
|
-
"devDependencies": {
|
|
18
|
-
"@types/bun": "latest",
|
|
19
|
-
"typescript": "^5.7.0"
|
|
20
|
-
},
|
|
21
|
-
"publishConfig": {
|
|
22
|
-
"access": "restricted",
|
|
23
|
-
"registry": "https://registry.npmjs.org/"
|
|
24
|
-
},
|
|
25
|
-
"files": [
|
|
26
|
-
"src",
|
|
27
|
-
"tsconfig.json"
|
|
28
|
-
]
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
10
|
+
}
|
|
29
11
|
}
|
|
@@ -1,29 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "icon-pack",
|
|
3
3
|
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Generate a coordinated icon pack as SVGs and transparent PNGs",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
|
|
8
|
-
"
|
|
9
|
-
},
|
|
10
|
-
"files": [
|
|
11
|
-
"README.md",
|
|
12
|
-
"SKILL.md"
|
|
13
|
-
],
|
|
14
|
-
"publishConfig": {
|
|
15
|
-
"access": "restricted"
|
|
16
|
-
},
|
|
17
|
-
"keywords": [
|
|
18
|
-
"icons",
|
|
19
|
-
"icon-pack",
|
|
20
|
-
"svg",
|
|
21
|
-
"png",
|
|
22
|
-
"design"
|
|
23
|
-
],
|
|
24
|
-
"scripts": {
|
|
25
|
-
"start": "bun run src/index.ts",
|
|
26
|
-
"dev": "bun --watch src/index.ts",
|
|
27
|
-
"typecheck": "tsc --noEmit"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
28
10
|
}
|
|
29
11
|
}
|
|
@@ -1,29 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "image",
|
|
3
3
|
"version": "1.0.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Generate images using provider-cost AI backends",
|
|
5
|
-
"main": "src/index.ts",
|
|
6
6
|
"type": "module",
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
|
|
10
|
-
"scripts": {
|
|
11
|
-
"start": "bun run src/index.ts",
|
|
12
|
-
"generate": "bun run src/index.ts generate"
|
|
13
|
-
},
|
|
14
|
-
"keywords": [
|
|
15
|
-
"image-generation",
|
|
16
|
-
"ai",
|
|
17
|
-
"openai",
|
|
18
|
-
"minimax",
|
|
19
|
-
"gemini",
|
|
20
|
-
"imagen"
|
|
21
|
-
],
|
|
22
|
-
"author": "",
|
|
23
|
-
"devDependencies": {
|
|
24
|
-
"@types/bun": "latest"
|
|
25
|
-
},
|
|
26
|
-
"peerDependencies": {
|
|
27
|
-
"typescript": "^5.0.0"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
28
10
|
}
|
|
29
11
|
}
|
|
@@ -1,14 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "landing-page-pack",
|
|
3
3
|
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
4
5
|
"description": "Hosted premium landing page copy and conversion artifact generator",
|
|
5
6
|
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
"dependencies": {},
|
|
10
|
-
"devDependencies": {
|
|
11
|
-
"@types/bun": "latest",
|
|
12
|
-
"typescript": "^5.7.0"
|
|
7
|
+
"skills": {
|
|
8
|
+
"runtime": "hosted",
|
|
9
|
+
"source": "remote"
|
|
13
10
|
}
|
|
14
11
|
}
|
|
@@ -1,48 +1,14 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Manage MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Use this skill as a public contract for MCP server management workflows.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
`managemcp` is a TypeScript service for managing MCP (Model Context Protocol) servers. It provides a CLI tool, REST API server, and PostgreSQL database for listing, installing, removing, and configuring MCP server connections.
|
|
8
|
-
|
|
9
|
-
## Architecture
|
|
10
|
-
|
|
11
|
-
- **CLI tool** (Commander.js) - Primary interface at `bin/cli.ts`
|
|
12
|
-
- **API server** (Bun HTTP) - REST API at `src/server/index.ts`
|
|
13
|
-
- **Database** (PostgreSQL) - Data persistence at `src/db/index.ts`
|
|
14
|
-
- **Config** - CLI config stored in `~/.managemcp.json`, server config via `.env`
|
|
15
|
-
|
|
16
|
-
## Key Directories
|
|
17
|
-
|
|
18
|
-
- `bin/` - CLI entry point
|
|
19
|
-
- `src/lib/` - Core logic (api-client, config, installer, service-dir)
|
|
20
|
-
- `src/server/` - HTTP server
|
|
21
|
-
- `src/db/` - Database connection
|
|
22
|
-
- `scripts/` - Database migration and seeding
|
|
23
|
-
|
|
24
|
-
## Guidelines
|
|
25
|
-
|
|
26
|
-
### DO:
|
|
27
|
-
- Use Bun-native APIs (Bun.serve, Bun file operations)
|
|
28
|
-
- Add TypeScript types for all new functions
|
|
29
|
-
- Use parameterized queries with the `sql` tagged template
|
|
30
|
-
- Handle errors gracefully with try-catch
|
|
31
|
-
- Keep CLI commands focused and single-purpose
|
|
32
|
-
- Use environment variables for secrets, config files for preferences
|
|
33
|
-
|
|
34
|
-
### DON'T:
|
|
35
|
-
- Don't add heavyweight frameworks (Express, Fastify, etc.)
|
|
36
|
-
- Don't use ORMs (use raw SQL via postgres library)
|
|
37
|
-
- Don't store secrets in code or config files
|
|
38
|
-
|
|
39
|
-
## Common Operations
|
|
5
|
+
Do not copy this skill into agent-native skill folders. Register the shared
|
|
6
|
+
Skills MCP server instead:
|
|
40
7
|
|
|
41
8
|
```bash
|
|
42
|
-
|
|
43
|
-
bun run start # Start server
|
|
44
|
-
bun run cli # Run CLI tool
|
|
45
|
-
bun run db:migrate # Run migrations
|
|
46
|
-
bun run db:seed # Seed database
|
|
47
|
-
bun run db:reset # Reset database (migrate + seed)
|
|
9
|
+
skills mcp --register all
|
|
48
10
|
```
|
|
11
|
+
|
|
12
|
+
The OSS package does not include a database-backed MCP catalog service,
|
|
13
|
+
migrations, hosted API server, or installer implementation. Those concerns
|
|
14
|
+
belong in the hosted platform or an external MCP management service.
|
|
@@ -1,210 +1,24 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Manage MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Public contract for managing MCP server connections.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## Boundary
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
The OSS package keeps a lightweight CLI stub and documentation only. It does not
|
|
8
|
+
ship a PostgreSQL service, REST API server, migration scripts, hosted registry,
|
|
9
|
+
or agent-folder installer implementation.
|
|
8
10
|
|
|
9
|
-
|
|
10
|
-
- HTTP server with REST API
|
|
11
|
-
- PostgreSQL database with migrations
|
|
12
|
-
- Configuration management
|
|
13
|
-
- Installer for Claude/Codex tools
|
|
14
|
-
|
|
15
|
-
## Installation
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
# Install dependencies
|
|
19
|
-
bun install
|
|
20
|
-
|
|
21
|
-
# Copy environment file
|
|
22
|
-
cp .env.example .env
|
|
23
|
-
|
|
24
|
-
# Edit .env with your configuration
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## Configuration
|
|
28
|
-
|
|
29
|
-
### Environment Variables
|
|
30
|
-
|
|
31
|
-
Edit `.env` file with your configuration:
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
# Database
|
|
35
|
-
DB_HOST=localhost
|
|
36
|
-
DB_PORT=5432
|
|
37
|
-
DB_NAME=managemcp_db
|
|
38
|
-
DB_USER=postgres
|
|
39
|
-
DB_PASSWORD=your-password-here
|
|
40
|
-
|
|
41
|
-
# Server
|
|
42
|
-
PORT=3000
|
|
43
|
-
|
|
44
|
-
# API
|
|
45
|
-
API_URL=https://api.example.com
|
|
46
|
-
API_KEY=your-api-key-here
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### CLI Configuration
|
|
50
|
-
|
|
51
|
-
Configure the CLI tool:
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
# Set API URL
|
|
55
|
-
bun cli config --set-api-url https://api.example.com
|
|
56
|
-
|
|
57
|
-
# Set API key
|
|
58
|
-
bun cli config --set-api-key your-api-key-here
|
|
59
|
-
|
|
60
|
-
# Show current configuration
|
|
61
|
-
bun cli config --show
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## Database Setup
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
# Run migrations
|
|
68
|
-
bun run db:migrate
|
|
69
|
-
|
|
70
|
-
# Seed database
|
|
71
|
-
bun run db:seed
|
|
72
|
-
|
|
73
|
-
# Reset database (migrate + seed)
|
|
74
|
-
bun run db:reset
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Development
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
# Start server with auto-reload
|
|
81
|
-
bun run dev
|
|
82
|
-
|
|
83
|
-
# Start server
|
|
84
|
-
bun run start
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
## CLI Usage
|
|
88
|
-
|
|
89
|
-
### Setup
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
# Interactive setup
|
|
93
|
-
bun run cli setup
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
### Managing MCP Servers
|
|
11
|
+
Use the shared Skills MCP registration flow for agent integration:
|
|
97
12
|
|
|
98
13
|
```bash
|
|
99
|
-
|
|
100
|
-
bun run cli list
|
|
101
|
-
|
|
102
|
-
# List with options
|
|
103
|
-
bun run cli list --filter "category" --limit 20
|
|
104
|
-
|
|
105
|
-
# Get MCP server by ID
|
|
106
|
-
bun run cli get <server-id>
|
|
107
|
-
|
|
108
|
-
# Search MCP servers
|
|
109
|
-
bun run cli search "query" --limit 10
|
|
110
|
-
|
|
111
|
-
# Add MCP server
|
|
112
|
-
bun run cli add --name "Server Name" --description "Description"
|
|
113
|
-
|
|
114
|
-
# Add MCP server with metadata
|
|
115
|
-
bun run cli add --name "Server" --metadata '{"key": "value"}'
|
|
14
|
+
skills mcp --register all
|
|
116
15
|
```
|
|
117
16
|
|
|
118
|
-
|
|
17
|
+
## Usage
|
|
119
18
|
|
|
120
19
|
```bash
|
|
121
|
-
|
|
122
|
-
bun run cli install <server-id>
|
|
123
|
-
|
|
124
|
-
# Install to specific target
|
|
125
|
-
bun run cli install <server-id> --target claude
|
|
126
|
-
bun run cli install <server-id> --target codex
|
|
127
|
-
|
|
128
|
-
# Install multiple servers
|
|
129
|
-
bun run cli install <id1> <id2> <id3>
|
|
130
|
-
|
|
131
|
-
# Force overwrite
|
|
132
|
-
bun run cli install <server-id> --force
|
|
133
|
-
|
|
134
|
-
# Clear installed servers
|
|
135
|
-
bun run cli install --clear
|
|
136
|
-
|
|
137
|
-
# List installed servers
|
|
138
|
-
bun run cli install --list
|
|
20
|
+
skills run managemcp --help
|
|
139
21
|
```
|
|
140
22
|
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
The server provides the following REST API endpoints:
|
|
144
|
-
|
|
145
|
-
### Health Check
|
|
146
|
-
|
|
147
|
-
```bash
|
|
148
|
-
GET /health
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
Returns server health status.
|
|
152
|
-
|
|
153
|
-
### Items
|
|
154
|
-
|
|
155
|
-
```bash
|
|
156
|
-
# List items
|
|
157
|
-
GET /api/items
|
|
158
|
-
|
|
159
|
-
# Create item
|
|
160
|
-
POST /api/items
|
|
161
|
-
Content-Type: application/json
|
|
162
|
-
|
|
163
|
-
{
|
|
164
|
-
"name": "Server name",
|
|
165
|
-
"description": "Server description",
|
|
166
|
-
"metadata": {"key": "value"}
|
|
167
|
-
}
|
|
168
|
-
```
|
|
169
|
-
|
|
170
|
-
## Project Structure
|
|
171
|
-
|
|
172
|
-
```
|
|
173
|
-
.
|
|
174
|
-
├── bin/
|
|
175
|
-
│ └── cli.ts # CLI entry point
|
|
176
|
-
├── src/
|
|
177
|
-
│ ├── lib/
|
|
178
|
-
│ │ ├── api-client.ts # API client functions
|
|
179
|
-
│ │ ├── config.ts # Configuration management
|
|
180
|
-
│ │ ├── installer.ts # Claude/Codex installer
|
|
181
|
-
│ │ └── service-dir.ts # Service directory management
|
|
182
|
-
│ ├── db/
|
|
183
|
-
│ │ └── index.ts # Database connection
|
|
184
|
-
│ └── server/
|
|
185
|
-
│ └── index.ts # HTTP server
|
|
186
|
-
├── scripts/
|
|
187
|
-
│ ├── migrate.ts # Database migrations
|
|
188
|
-
│ └── seed.ts # Database seeding
|
|
189
|
-
├── .env.example # Environment template
|
|
190
|
-
├── package.json # Package configuration
|
|
191
|
-
├── tsconfig.json # TypeScript config
|
|
192
|
-
└── README.md # Documentation
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
## Scripts
|
|
196
|
-
|
|
197
|
-
- `bun run dev` - Start server with auto-reload
|
|
198
|
-
- `bun run start` - Start server
|
|
199
|
-
- `bun run cli` - Run CLI tool
|
|
200
|
-
- `bun run db:migrate` - Run migrations
|
|
201
|
-
- `bun run db:seed` - Seed database
|
|
202
|
-
- `bun run db:reset` - Reset database (migrate + seed)
|
|
203
|
-
|
|
204
|
-
## License
|
|
205
|
-
|
|
206
|
-
Apache-2.0
|
|
207
|
-
|
|
208
|
-
## Author
|
|
209
|
-
|
|
210
|
-
Hasna
|
|
23
|
+
Hosted MCP catalog state, account-scoped server listings, billing, and
|
|
24
|
+
connector management belong in the hosted platform or an external service.
|