@hasna/connectors 0.5.7 → 0.5.8
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 +48 -9
- package/bin/index.js +1 -1
- package/bin/mcp.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,21 +1,42 @@
|
|
|
1
1
|
# Connectors
|
|
2
2
|
|
|
3
|
-
Open source library of
|
|
3
|
+
Open source library of 126 TypeScript API connectors. Set up any connector in 30 seconds.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 30-Second Quickstart
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Install globally
|
|
9
|
+
bun install -g @hasna/connectors
|
|
10
|
+
|
|
11
|
+
# Set up a connector (install + auth in one step)
|
|
12
|
+
connectors setup stripe --key sk_test_your_key_here
|
|
13
|
+
|
|
14
|
+
# Use it immediately
|
|
15
|
+
connectors run stripe products list
|
|
16
|
+
connectors run stripe customers create --email "test@example.com"
|
|
17
|
+
|
|
18
|
+
# Discover what any connector can do
|
|
19
|
+
connectors ops stripe
|
|
20
|
+
connectors ops gmail
|
|
21
|
+
connectors ops anthropic
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
**That's it.** `setup` installs the connector and saves your API key. `run` executes any operation. `ops` shows what's available.
|
|
25
|
+
|
|
26
|
+
## Quick Start (Alternative Methods)
|
|
6
27
|
|
|
7
28
|
```bash
|
|
8
29
|
# Interactive mode - browse and select connectors
|
|
9
30
|
npx @hasna/connectors
|
|
10
31
|
|
|
11
32
|
# Install specific connectors
|
|
12
|
-
|
|
33
|
+
connectors install figma stripe github
|
|
13
34
|
|
|
14
|
-
# List all
|
|
15
|
-
|
|
35
|
+
# List all 126 connectors
|
|
36
|
+
connectors list
|
|
16
37
|
|
|
17
38
|
# Open the auth dashboard
|
|
18
|
-
|
|
39
|
+
connectors serve
|
|
19
40
|
```
|
|
20
41
|
|
|
21
42
|
## Installation
|
|
@@ -69,7 +90,7 @@ connectors open # Open dashboard in browser
|
|
|
69
90
|
connectors dashboard # Alias for serve
|
|
70
91
|
```
|
|
71
92
|
|
|
72
|
-
The dashboard shows all
|
|
93
|
+
The dashboard shows all 126 connectors with:
|
|
73
94
|
- Install status and auth type (OAuth, API Key, Bearer)
|
|
74
95
|
- Configure API keys via dialog
|
|
75
96
|
- Run OAuth flows for Google connectors
|
|
@@ -93,7 +114,25 @@ Add to your MCP config:
|
|
|
93
114
|
}
|
|
94
115
|
```
|
|
95
116
|
|
|
96
|
-
Tools: `search_connectors`, `list_connectors`, `list_categories`, `connector_docs`, `connector_info`, `install_connector`, `remove_connector`, `list_installed`, `connector_auth_status`, `configure_auth`
|
|
117
|
+
Tools: `search_connectors`, `list_connectors`, `list_categories`, `connector_docs`, `connector_info`, `install_connector`, `remove_connector`, `list_installed`, `connector_auth_status`, `configure_auth`, `setup_connector`, `list_connector_operations`, `run_connector_operation`
|
|
118
|
+
|
|
119
|
+
### Use Connectors (ops + run)
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
# Discover what a connector can do
|
|
123
|
+
connectors ops stripe # List all operations
|
|
124
|
+
connectors ops stripe products # Detailed help for products
|
|
125
|
+
|
|
126
|
+
# Execute any operation
|
|
127
|
+
connectors run stripe products list --limit 5
|
|
128
|
+
connectors run anthropic models
|
|
129
|
+
connectors run gmail messages list --limit 10
|
|
130
|
+
connectors run github repo list
|
|
131
|
+
|
|
132
|
+
# One-step setup (install + auth + verify)
|
|
133
|
+
connectors setup anthropic --key your-anthropic-api-key
|
|
134
|
+
connectors setup stripe --key sk_test_your-key
|
|
135
|
+
```
|
|
97
136
|
|
|
98
137
|
### JSON Output (for scripts & agents)
|
|
99
138
|
|
|
@@ -106,7 +145,7 @@ connectors info stripe --json
|
|
|
106
145
|
connectors docs gmail --json
|
|
107
146
|
```
|
|
108
147
|
|
|
109
|
-
## Available Connectors (
|
|
148
|
+
## Available Connectors (126)
|
|
110
149
|
|
|
111
150
|
### AI & ML (12)
|
|
112
151
|
| Connector | Description |
|
package/bin/index.js
CHANGED
|
@@ -7314,7 +7314,7 @@ var PRESETS = {
|
|
|
7314
7314
|
commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
|
|
7315
7315
|
};
|
|
7316
7316
|
var program2 = new Command;
|
|
7317
|
-
program2.name("connectors").description("Install API connectors for your project").version("0.5.
|
|
7317
|
+
program2.name("connectors").description("Install API connectors for your project").version("0.5.8").enablePositionalOptions();
|
|
7318
7318
|
program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
|
|
7319
7319
|
if (!isTTY) {
|
|
7320
7320
|
console.log(`Non-interactive environment detected. Use a subcommand:
|
package/bin/mcp.js
CHANGED
|
@@ -20796,7 +20796,7 @@ async function getConnectorCommandHelp(name, command) {
|
|
|
20796
20796
|
loadConnectorVersions();
|
|
20797
20797
|
var server = new McpServer({
|
|
20798
20798
|
name: "connectors",
|
|
20799
|
-
version: "0.5.
|
|
20799
|
+
version: "0.5.8"
|
|
20800
20800
|
});
|
|
20801
20801
|
server.registerTool("search_connectors", {
|
|
20802
20802
|
title: "Search Connectors",
|