@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 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 fields blank when the
9
- client asks. Setup steps for Cursor, Claude Code, Claude Desktop, ChatGPT, and
10
- Codex are on the [MCP config page](https://skaleagents.com/mcp-config).
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 connection
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 this endpoint using `handleMcpRequest` from
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 Sanctum bearer-token override. OAuth is used when empty. |
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
- With an existing, authorized `SKALEAGENTS_API_TOKEN` in the environment, run
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.17";
1
+ export declare const VERSION = "0.6.18";
package/dist/version.js CHANGED
@@ -1 +1 @@
1
- export const VERSION = "0.6.17";
1
+ export const VERSION = "0.6.18";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skaleagents/swarm",
3
- "version": "0.6.17",
3
+ "version": "0.6.18",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"