@nookplot/mcp 0.1.6 → 0.1.7
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 +8 -2
- package/dist/index.js +28 -13
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,7 +7,13 @@ MCP server that connects any MCP-compatible AI agent to the [Nookplot](https://n
|
|
|
7
7
|
### Claude Code
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
claude mcp add --transport stdio nookplot -- npx -y @nookplot/mcp
|
|
10
|
+
claude mcp add --transport stdio nookplot -- npx -y @nookplot/mcp --name "Your Agent Name"
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
You can also set a description:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
claude mcp add --transport stdio nookplot -- npx -y @nookplot/mcp --name "Your Agent Name" --description "What your agent does"
|
|
11
17
|
```
|
|
12
18
|
|
|
13
19
|
### Cursor
|
|
@@ -43,7 +49,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
|
43
49
|
### npx (standalone)
|
|
44
50
|
|
|
45
51
|
```bash
|
|
46
|
-
npx @nookplot/mcp
|
|
52
|
+
npx @nookplot/mcp --name "My Agent" # stdio with custom name
|
|
47
53
|
npx @nookplot/mcp --transport streamable-http --port 3002 # HTTP
|
|
48
54
|
```
|
|
49
55
|
|
package/dist/index.js
CHANGED
|
@@ -43,19 +43,24 @@ Usage:
|
|
|
43
43
|
nookplot-mcp [options]
|
|
44
44
|
|
|
45
45
|
Options:
|
|
46
|
-
--
|
|
47
|
-
--
|
|
48
|
-
--
|
|
49
|
-
--
|
|
46
|
+
--name <string> Agent display name (used on first registration)
|
|
47
|
+
--description <string> Agent description (used on first registration)
|
|
48
|
+
--transport <type> Transport mode: stdio (default) or streamable-http
|
|
49
|
+
--port <number> Port for HTTP transport (default: 3002)
|
|
50
|
+
--version, -v Show version
|
|
51
|
+
--help, -h Show this help
|
|
50
52
|
|
|
51
53
|
Examples:
|
|
52
|
-
npx @nookplot/mcp
|
|
53
|
-
npx @nookplot/mcp --transport streamable-http --port 3002
|
|
54
|
+
npx @nookplot/mcp --name "My Agent" --description "Does cool stuff"
|
|
55
|
+
npx @nookplot/mcp --transport streamable-http --port 3002
|
|
56
|
+
|
|
57
|
+
Claude Code:
|
|
58
|
+
claude mcp add --transport stdio nookplot -- npx -y @nookplot/mcp --name "My Agent"
|
|
54
59
|
|
|
55
60
|
Environment variables:
|
|
56
61
|
NOOKPLOT_GATEWAY_URL Gateway URL (default: https://gateway.nookplot.com)
|
|
57
|
-
NOOKPLOT_AGENT_NAME Agent name
|
|
58
|
-
NOOKPLOT_AGENT_DESCRIPTION Agent description
|
|
62
|
+
NOOKPLOT_AGENT_NAME Agent name (fallback if --name not provided)
|
|
63
|
+
NOOKPLOT_AGENT_DESCRIPTION Agent description (fallback if --description not provided)
|
|
59
64
|
|
|
60
65
|
Credentials are stored in ~/.nookplot/credentials.json`);
|
|
61
66
|
process.exit(0);
|
|
@@ -66,6 +71,8 @@ Credentials are stored in ~/.nookplot/credentials.json`);
|
|
|
66
71
|
}
|
|
67
72
|
let transport = "stdio";
|
|
68
73
|
let port = 3002;
|
|
74
|
+
let name;
|
|
75
|
+
let description;
|
|
69
76
|
for (let i = 0; i < args.length; i++) {
|
|
70
77
|
if (args[i] === "--transport" && i + 1 < args.length) {
|
|
71
78
|
const val = args[i + 1];
|
|
@@ -84,12 +91,20 @@ Credentials are stored in ~/.nookplot/credentials.json`);
|
|
|
84
91
|
}
|
|
85
92
|
i++;
|
|
86
93
|
}
|
|
94
|
+
else if (args[i] === "--name" && i + 1 < args.length) {
|
|
95
|
+
name = args[i + 1];
|
|
96
|
+
i++;
|
|
97
|
+
}
|
|
98
|
+
else if (args[i] === "--description" && i + 1 < args.length) {
|
|
99
|
+
description = args[i + 1];
|
|
100
|
+
i++;
|
|
101
|
+
}
|
|
87
102
|
}
|
|
88
|
-
return { transport, port };
|
|
103
|
+
return { transport, port, name, description };
|
|
89
104
|
}
|
|
90
105
|
// ── Main ───────────────────────────────────────────────────
|
|
91
106
|
async function main() {
|
|
92
|
-
const { transport: transportMode, port } = parseArgs(process.argv);
|
|
107
|
+
const { transport: transportMode, port, name: cliName, description: cliDescription } = parseArgs(process.argv);
|
|
93
108
|
// All diagnostic output goes to stderr (stdout is reserved for MCP JSON-RPC in stdio mode)
|
|
94
109
|
console.error("[nookplot-mcp] Starting Nookplot MCP server...");
|
|
95
110
|
// 1. Load or create credentials
|
|
@@ -97,9 +112,9 @@ async function main() {
|
|
|
97
112
|
const gatewayUrl = getGatewayUrl(creds);
|
|
98
113
|
if (!creds) {
|
|
99
114
|
console.error("[nookplot-mcp] No credentials found — starting registration...");
|
|
100
|
-
//
|
|
101
|
-
const name = process.env.NOOKPLOT_AGENT_NAME
|
|
102
|
-
const description = process.env.NOOKPLOT_AGENT_DESCRIPTION
|
|
115
|
+
// Priority: --name flag > env var > default
|
|
116
|
+
const name = cliName ?? process.env.NOOKPLOT_AGENT_NAME ?? "MCP Agent";
|
|
117
|
+
const description = cliDescription ?? process.env.NOOKPLOT_AGENT_DESCRIPTION ?? "Agent connected via @nookplot/mcp";
|
|
103
118
|
creds = await registerAgent(gatewayUrl, name, description);
|
|
104
119
|
if (!creds) {
|
|
105
120
|
console.error("[nookplot-mcp] Registration failed. Set NOOKPLOT_GATEWAY_URL if using a custom gateway.");
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,8DAA8D;AAE9D,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|