@skaleagents/swarm 0.6.17 → 0.6.18
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 +9 -89
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,12 +5,9 @@ SkaleAgents MCP server. The hosted connection is `https://skaleagents.com/mcp`.
|
|
|
5
5
|
## Quick start
|
|
6
6
|
|
|
7
7
|
Copy `https://skaleagents.com/mcp` into your client and choose OAuth. Sign in
|
|
8
|
-
with Google and click Allow. Leave client ID and secret
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
The hosted URL is the way to connect. A local stdio process can still run this
|
|
13
|
-
package; it opens the browser for OAuth when no token is set.
|
|
8
|
+
with Google and click Allow. Leave client ID and secret blank when the client
|
|
9
|
+
asks. Setup steps for Cursor, Claude Code, Claude Desktop, ChatGPT, and Codex
|
|
10
|
+
are on the [MCP config page](https://skaleagents.com/mcp-config).
|
|
14
11
|
|
|
15
12
|
Tools: `plan_architecture_review`, `review_application_architecture`,
|
|
16
13
|
`review_architecture`, and `scan_iac`. The older `scan_iac_stub` name remains
|
|
@@ -111,15 +108,9 @@ locations point to resource declarations; property paths identify the setting.
|
|
|
111
108
|
YAML aliases must be expanded before submission. Coverage limits are included
|
|
112
109
|
in every result. An empty finding list is not proof that a system is secure.
|
|
113
110
|
|
|
114
|
-
## Hosted
|
|
115
|
-
|
|
116
|
-
Use `https://skaleagents.com/mcp` in Claude Desktop or ChatGPT's custom connector
|
|
117
|
-
settings. Choose OAuth and leave client ID and secret fields blank. The client
|
|
118
|
-
registers itself, opens Google sign-in, and asks you to click Allow.
|
|
119
|
-
See [client setup](https://skaleagents.com/mcp-config) for Cursor, Claude Code,
|
|
120
|
-
Claude Desktop, ChatGPT, and Codex instructions.
|
|
111
|
+
## Hosted transport
|
|
121
112
|
|
|
122
|
-
The web app hosts
|
|
113
|
+
The web app hosts `https://skaleagents.com/mcp` using `handleMcpRequest` from
|
|
123
114
|
`@skaleagents/swarm/http`. Audit workers import `scanIac` from
|
|
124
115
|
`@skaleagents/swarm/scan`. It validates each bearer credential with the API's
|
|
125
116
|
`/api/oauth/mcp-token` endpoint before running a tool. Tokens are bound to the
|
|
@@ -129,94 +120,23 @@ forwarded to the public bot directory.
|
|
|
129
120
|
`protectedResourceMetadata` exports the discovery response for
|
|
130
121
|
`/.well-known/oauth-protected-resource/mcp`.
|
|
131
122
|
|
|
132
|
-
## Local stdio prerequisites
|
|
133
|
-
|
|
134
|
-
1. Node.js 20 or newer. The client connects to `https://api.skaleagents.com` by default.
|
|
135
|
-
2. A browser that can open the SkaleAgents sign-in page.
|
|
136
|
-
|
|
137
|
-
The first tool call opens browser sign-in. Approve MCP access there and return
|
|
138
|
-
to your AI client. The package stores the OAuth refresh credential locally and
|
|
139
|
-
refreshes access automatically. Active connections can be revoked from the
|
|
140
|
-
[MCP config page](https://skaleagents.com/mcp-config).
|
|
141
|
-
|
|
142
|
-
Local `review_architecture` calls validate the account and fetch public bot
|
|
143
|
-
hints concurrently. The public directory request carries no credential. Every
|
|
144
|
-
review still requires successful account validation. An anonymous directory
|
|
145
|
-
request may already be in flight when validation rejects a connection.
|
|
146
|
-
|
|
147
123
|
## Local development
|
|
148
124
|
|
|
125
|
+
People working on this repo need Node.js 20 or newer. This is not the way to connect a client.
|
|
126
|
+
|
|
149
127
|
```bash
|
|
150
128
|
git clone https://github.com/SkaleAgents/mcp-server.git
|
|
151
129
|
cd mcp-server
|
|
152
130
|
npm install
|
|
153
|
-
cp .env.example .env
|
|
154
131
|
npm run build
|
|
155
132
|
npm test
|
|
156
|
-
npm run smoke # needs API on :8082
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
## Cursor
|
|
160
|
-
|
|
161
|
-
Add to `.cursor/mcp.json` (project) or Cursor Settings → MCP:
|
|
162
|
-
|
|
163
|
-
### Option A: local clone (recommended while API is local)
|
|
164
|
-
|
|
165
|
-
```json
|
|
166
|
-
{
|
|
167
|
-
"mcpServers": {
|
|
168
|
-
"skaleagents": {
|
|
169
|
-
"command": "node",
|
|
170
|
-
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
|
|
171
|
-
"env": {
|
|
172
|
-
"PLATFORM_API_URL": "http://localhost:8082"
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
133
|
```
|
|
178
134
|
|
|
179
|
-
Dev without build:
|
|
180
|
-
|
|
181
|
-
```json
|
|
182
|
-
{
|
|
183
|
-
"mcpServers": {
|
|
184
|
-
"skaleagents": {
|
|
185
|
-
"command": "npx",
|
|
186
|
-
"args": ["tsx", "/absolute/path/to/mcp-server/src/index.ts"],
|
|
187
|
-
"env": {
|
|
188
|
-
"PLATFORM_API_URL": "http://localhost:8082"
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
### Option B: published package (hosted API)
|
|
196
|
-
|
|
197
|
-
```json
|
|
198
|
-
{
|
|
199
|
-
"mcpServers": {
|
|
200
|
-
"skaleagents": {
|
|
201
|
-
"command": "npx",
|
|
202
|
-
"args": ["-y", "@skaleagents/swarm@0.6.1"]
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
}
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
Reconnect after upgrading to refresh the tool catalog. The consultation tools,
|
|
209
|
-
snippet review, IaC scanner, and compatibility alias should all appear.
|
|
210
|
-
|
|
211
|
-
## Claude Code
|
|
212
|
-
|
|
213
|
-
Use the published package configuration above in `.mcp.json`. OAuth starts on the first tool call. No API URL or keys are needed.
|
|
214
|
-
|
|
215
135
|
## Environment
|
|
216
136
|
|
|
217
137
|
| Variable | Required | Description |
|
|
218
138
|
|----------|----------|-------------|
|
|
219
|
-
| `SKALEAGENTS_API_TOKEN` | No | Legacy
|
|
139
|
+
| `SKALEAGENTS_API_TOKEN` | No | Legacy override for CI only, not the way to connect. |
|
|
220
140
|
| `PLATFORM_API_URL` | No | Defaults to `https://api.skaleagents.com`. Override only for local development or another API deployment. Empty values use the default. |
|
|
221
141
|
| `SKALEAGENTS_OAUTH_CACHE` | No | OAuth cache path. Default `~/.config/skaleagents/oauth.json`. |
|
|
222
142
|
| `SKALEAGENTS_OAUTH_ENABLED` | No | Set to `false` only to disable browser OAuth. |
|
|
@@ -224,7 +144,7 @@ Use the published package configuration above in `.mcp.json`. OAuth starts on th
|
|
|
224
144
|
|
|
225
145
|
## Steady-state tool latency probe
|
|
226
146
|
|
|
227
|
-
|
|
147
|
+
This probe uses the legacy `SKALEAGENTS_API_TOKEN` CI override. It is not how a client connects. With that variable already set, run
|
|
228
148
|
`npm run benchmark:tool`. The script builds this checkout, starts its stdio MCP
|
|
229
149
|
server, makes five warmup calls, then times 50 `review_architecture` calls on a
|
|
230
150
|
fixed synthetic application snippet. Set `BENCHMARK_WARMUP` from 0 to 20 and
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const VERSION = "0.6.
|
|
1
|
+
export declare const VERSION = "0.6.18";
|
package/dist/version.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const VERSION = "0.6.
|
|
1
|
+
export const VERSION = "0.6.18";
|