@hasna/mcps 0.0.15 → 0.0.17

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 CHANGED
@@ -27,6 +27,11 @@ mcps --help
27
27
  - `mcps call`
28
28
  - `mcps info`
29
29
  - `mcps doctor`
30
+ - `mcps providers list`
31
+ - `mcps providers search github`
32
+ - `mcps providers install github`
33
+ - `mcps env list <server-id>`
34
+ - `mcps env ref <server-id> API_KEY=UPSTREAM_API_KEY --source env`
30
35
  - `mcps machines list`
31
36
  - `mcps machines add --host spark01 --platform linux --arch arm64`
32
37
  - `mcps machines seed-defaults`
@@ -53,6 +58,42 @@ Notes:
53
58
  - Targets need SSH access plus `node` and either `bun` or `npm` available remotely.
54
59
  - Use `-j` or `--json` on the new `machines` and `fleet` commands for scriptable output.
55
60
 
61
+ ## Curated Provider Profiles
62
+
63
+ `mcps providers` exposes a curated catalog of common MCP providers with source,
64
+ auth, transport, and install metadata. The default catalog includes Notion,
65
+ Linear, GitHub, Slack, Gmail, Google Drive, Google Calendar, Stripe, Cloudflare,
66
+ PostgreSQL, filesystem, and browser automation profiles.
67
+
68
+ ```bash
69
+ mcps providers list
70
+ mcps providers info github --json
71
+ mcps providers install github
72
+ ```
73
+
74
+ Direct remote providers install as HTTP/SSE entries. Local stdio fallbacks such
75
+ as PostgreSQL, filesystem, and Playwright browser automation require explicit
76
+ local command consent before registration.
77
+
78
+ ## Credential References
79
+
80
+ Secret-like environment keys and values are rejected from plain server env storage.
81
+ Use credential references instead so exports, MCP tools, API responses, logs, and
82
+ diagnostics never contain raw credential values.
83
+
84
+ ```bash
85
+ mcps add --yes --name notion npx -y @notion/mcp --credential-env NOTION_TOKEN=NOTION_TOKEN
86
+ mcps env ref notion API_KEY=UPSTREAM_API_KEY --source env
87
+ mcps env ref notion API_KEY=notion-token --source local-vault
88
+ mcps env ref notion API_KEY=cred_123 --source hosted
89
+ ```
90
+
91
+ Local runtime resolution supports `env` and `local-vault` references. The local
92
+ vault defaults to `~/.hasna/mcps/credentials.local.json`; set
93
+ `HASNA_MCPS_CREDENTIAL_VAULT_PATH` to use a different JSON file. Hosted
94
+ credential references are recorded for platforms that resolve credentials outside
95
+ the local runtime.
96
+
56
97
  ## MCP Server
57
98
 
58
99
  ```bash