@magicsword-io/magicsword-mcp 0.1.3 → 0.1.4
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 +25 -0
- package/package.json +9 -4
package/README.md
CHANGED
|
@@ -16,6 +16,31 @@ the user's machine, holds an `msk_…` API key, and speaks MCP over stdio.
|
|
|
16
16
|
|
|
17
17
|
## Quick start
|
|
18
18
|
|
|
19
|
+
### Claude Desktop installer
|
|
20
|
+
|
|
21
|
+
For Claude Desktop on macOS or Windows, download **magicsword-mcp.mcpb** from
|
|
22
|
+
[GitHub Releases](https://github.com/magicsword-io/magicsword-mcp/releases).
|
|
23
|
+
The installer is included starting with version **0.1.4**. If that release is
|
|
24
|
+
not available yet, use terminal setup below.
|
|
25
|
+
|
|
26
|
+
1. Generate an Enterprise API key in **Magic Portal → Settings → API Keys**.
|
|
27
|
+
Start with read scopes for endpoints, alerts, and policies.
|
|
28
|
+
2. In Claude Desktop, open **Settings → Extensions → Advanced settings →
|
|
29
|
+
Install Extension…**, then select the downloaded `.mcpb` file.
|
|
30
|
+
3. Review the extension and enter your API key in its secure configuration
|
|
31
|
+
field. Claude stores this sensitive field using the operating system's
|
|
32
|
+
secure storage. The installer does not save a separate MagicSword key file.
|
|
33
|
+
4. Start a new conversation, then ask MagicSword to call `whoami` followed by
|
|
34
|
+
`list_endpoints`. Confirm the organization and scopes.
|
|
35
|
+
|
|
36
|
+
The installer includes the server and production dependencies and uses Claude
|
|
37
|
+
Desktop's bundled Node runtime (22+). It requires no npm installation or JSON
|
|
38
|
+
editing. Its SHA256 checksum is published beside the installer. A privately
|
|
39
|
+
downloaded extension must be updated by installing a newer `.mcpb` file;
|
|
40
|
+
automatic directory updates require a reviewed directory listing.
|
|
41
|
+
|
|
42
|
+
### Terminal setup
|
|
43
|
+
|
|
19
44
|
Requires **Node.js 22+**, an installed MCP client, and a MagicSword Enterprise
|
|
20
45
|
API key from **Magic Portal → Settings → API Keys**.
|
|
21
46
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@magicsword-io/magicsword-mcp",
|
|
3
3
|
"mcpName": "io.github.magicsword-io/magicsword-mcp",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.4",
|
|
5
5
|
"description": "MagicSword MCP server — manage MagicSword conversationally from Claude Desktop, Cursor, or any MCP-aware client.",
|
|
6
6
|
"license": "Apache-2.0",
|
|
7
7
|
"type": "module",
|
|
@@ -20,11 +20,13 @@
|
|
|
20
20
|
"node": ">=22"
|
|
21
21
|
},
|
|
22
22
|
"scripts": {
|
|
23
|
-
"build": "tsc -p tsconfig.json && node scripts/postbuild.mjs",
|
|
23
|
+
"build": "node scripts/clean.mjs && tsc -p tsconfig.json && node scripts/postbuild.mjs",
|
|
24
24
|
"start": "node dist/index.js",
|
|
25
25
|
"configure": "node dist/index.js configure",
|
|
26
26
|
"test": "npm run build && node --test scripts/verify-release.test.mjs scripts/configure.test.mjs scripts/install-links.test.mjs scripts/policy-rules.test.mjs scripts/policy-rules-stdio.test.mjs scripts/tools-stdio.test.mjs scripts/enforcement.test.mjs scripts/intel-sources.test.mjs scripts/investigate.test.mjs && node scripts/client.mjs && node scripts/smoke.mjs",
|
|
27
27
|
"test:package": "npm run build && node scripts/package-smoke.mjs",
|
|
28
|
+
"bundle:desktop": "npm run build && node scripts/build-mcpb.mjs",
|
|
29
|
+
"test:desktop": "node scripts/desktop-smoke.mjs",
|
|
28
30
|
"version": "node scripts/sync-registry-version.mjs",
|
|
29
31
|
"release:sync": "node scripts/sync-registry-version.mjs",
|
|
30
32
|
"release:verify": "node scripts/verify-release.mjs",
|
|
@@ -34,12 +36,15 @@
|
|
|
34
36
|
},
|
|
35
37
|
"dependencies": {
|
|
36
38
|
"@modelcontextprotocol/server": "^2.3.1",
|
|
37
|
-
"undici": "^7.
|
|
38
|
-
"zod": "^4.
|
|
39
|
+
"undici": "^7.30.1",
|
|
40
|
+
"zod": "^4.6.7"
|
|
39
41
|
},
|
|
40
42
|
"devDependencies": {
|
|
41
43
|
"@modelcontextprotocol/client": "^2.3.1",
|
|
42
44
|
"@types/node": "^22.10.0",
|
|
45
|
+
"ajv": "8.20.0",
|
|
46
|
+
"ajv-formats": "3.0.1",
|
|
47
|
+
"fflate": "0.8.3",
|
|
43
48
|
"typescript": "^5.6.3"
|
|
44
49
|
},
|
|
45
50
|
"repository": {
|