@terpomosoft/pmitz-mcp 0.1.0 → 0.1.1
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 +3 -3
- package/package.json +4 -4
- package/pmitz-mcp.mjs +9 -9
package/README.md
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
A local MCP server that lets a coding assistant read and change your own [Pmitz](https://github.com/terpomo-io/pmitz) server through its REST API. It needs Node.js 18 or newer and has no dependencies.
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
|
-
codex mcp add pmitz -- npx -y @terpomosoft/pmitz-mcp@0.1.
|
|
7
|
-
claude mcp add pmitz -- npx -y @terpomosoft/pmitz-mcp@0.1.
|
|
6
|
+
codex mcp add pmitz-local -- npx -y @terpomosoft/pmitz-mcp@0.1.1
|
|
7
|
+
claude mcp add pmitz-local -- npx -y @terpomosoft/pmitz-mcp@0.1.1
|
|
8
8
|
```
|
|
9
9
|
|
|
10
10
|
Set these in the environment the assistant starts from:
|
|
@@ -17,4 +17,4 @@ Set these in the environment the assistant starts from:
|
|
|
17
17
|
|
|
18
18
|
The server offers eleven tools: it checks entitlements and limits, reads subscriptions, creates and removes products and subscriptions, and records or reduces usage. A Pmitz API key has full authority over its server, so connect a development server, or use read-only mode.
|
|
19
19
|
|
|
20
|
-
The tools and settings are described in the [Pmitz plugin README](https://github.com/terpomo-io/pmitz/tree/main/plugins/pmitz#your-own-server-the-local-
|
|
20
|
+
The tools and settings are described in the [Pmitz plugin README](https://github.com/terpomo-io/pmitz-plugin/tree/main/plugins/pmitz#your-own-server-the-local-mcp-server). The plugin bundles this server for Claude Code and Codex, together with a skill and a hosted MCP server that creates a Pmitz sandbox for development and testing.
|
package/package.json
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@terpomosoft/pmitz-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Local MCP server for Pmitz: lets a coding assistant read and change your own Pmitz server.",
|
|
5
5
|
"keywords": ["mcp", "pmitz", "subscriptions", "entitlements", "usage-limits"],
|
|
6
6
|
"license": "Apache-2.0",
|
|
7
7
|
"author": "Terpomo Software (https://terpomosoft.com/)",
|
|
8
|
-
"homepage": "https://github.com/terpomo-io/pmitz/tree/main/plugins/pmitz#your-own-server-the-local-
|
|
9
|
-
"bugs": "https://github.com/terpomo-io/pmitz/issues",
|
|
8
|
+
"homepage": "https://github.com/terpomo-io/pmitz-plugin/tree/main/plugins/pmitz#your-own-server-the-local-mcp-server",
|
|
9
|
+
"bugs": "https://github.com/terpomo-io/pmitz-plugin/issues",
|
|
10
10
|
"repository": {
|
|
11
11
|
"type": "git",
|
|
12
|
-
"url": "git+https://github.com/terpomo-io/pmitz.git",
|
|
12
|
+
"url": "git+https://github.com/terpomo-io/pmitz-plugin.git",
|
|
13
13
|
"directory": "plugins/pmitz/server"
|
|
14
14
|
},
|
|
15
15
|
"type": "module",
|
package/pmitz-mcp.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
// Pmitz MCP
|
|
2
|
+
// Pmitz local MCP server.
|
|
3
3
|
//
|
|
4
4
|
// A local MCP server (stdio, JSON-RPC 2.0) that lets a coding assistant inspect and change a
|
|
5
5
|
// Pmitz server through its REST API. It has no dependencies and needs Node.js 18 or newer.
|
|
@@ -16,7 +16,7 @@ import { createInterface } from 'node:readline';
|
|
|
16
16
|
import { fileURLToPath } from 'node:url';
|
|
17
17
|
|
|
18
18
|
const SERVER_NAME = 'pmitz';
|
|
19
|
-
const SERVER_VERSION = '0.1.
|
|
19
|
+
const SERVER_VERSION = '0.1.1';
|
|
20
20
|
const SUPPORTED_PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'];
|
|
21
21
|
const REQUEST_TIMEOUT_MS = 15000;
|
|
22
22
|
const GROUP_TYPES = ['subscriptions', 'users', 'directory-groups'];
|
|
@@ -102,7 +102,7 @@ const TOOLS = [
|
|
|
102
102
|
{
|
|
103
103
|
name: 'pmitz_connection_status',
|
|
104
104
|
write: false,
|
|
105
|
-
description: 'Shows which Pmitz server
|
|
105
|
+
description: 'Shows which Pmitz server these tools are configured for, whether it is reachable, and '
|
|
106
106
|
+ 'whether it is in read-only mode. It never shows the API key.',
|
|
107
107
|
inputSchema: { type: 'object', properties: {}, additionalProperties: false },
|
|
108
108
|
},
|
|
@@ -502,11 +502,11 @@ export function createToolset(context) {
|
|
|
502
502
|
throw new ToolError(`Unknown tool: ${name}.`);
|
|
503
503
|
}
|
|
504
504
|
if (tool.write && context.readOnly) {
|
|
505
|
-
throw new ToolError(context.readOnlyMessage ?? '
|
|
506
|
-
+ 'that off by unsetting PMITZ_MCP_READ_ONLY and restarting
|
|
505
|
+
throw new ToolError(context.readOnlyMessage ?? 'This MCP server is in read-only mode. A person has to turn '
|
|
506
|
+
+ 'that off by unsetting PMITZ_MCP_READ_ONLY and restarting it.');
|
|
507
507
|
}
|
|
508
508
|
if (name !== 'pmitz_connection_status' && problems.length > 0) {
|
|
509
|
-
throw new ToolError('
|
|
509
|
+
throw new ToolError('This MCP server is not configured: ' + problems.join(' '));
|
|
510
510
|
}
|
|
511
511
|
if (args === null || typeof args !== 'object' || Array.isArray(args)) {
|
|
512
512
|
throw new ToolError('Tool arguments must be an object.');
|
|
@@ -517,7 +517,7 @@ export function createToolset(context) {
|
|
|
517
517
|
return { listTools, callTool };
|
|
518
518
|
}
|
|
519
519
|
|
|
520
|
-
// The toolset for the server named in the environment: what the stdio
|
|
520
|
+
// The toolset for the server named in the environment: what the stdio MCP server offers.
|
|
521
521
|
function createLocalToolset(config) {
|
|
522
522
|
return createToolset({
|
|
523
523
|
server: config.baseUrl,
|
|
@@ -590,7 +590,7 @@ async function handle(message) {
|
|
|
590
590
|
protocolVersion,
|
|
591
591
|
capabilities: { tools: {} },
|
|
592
592
|
serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
|
|
593
|
-
instructions: 'Tools for one Pmitz server chosen in the
|
|
593
|
+
instructions: 'Tools for one Pmitz server chosen in the settings of this MCP server. Call '
|
|
594
594
|
+ 'pmitz_connection_status first to see which server it is. The tools that change the server '
|
|
595
595
|
+ 'act on real data: confirm with the user before using them.',
|
|
596
596
|
});
|
|
@@ -613,7 +613,7 @@ async function handle(message) {
|
|
|
613
613
|
}
|
|
614
614
|
else {
|
|
615
615
|
process.stderr.write(`pmitz-mcp: unexpected error in ${params?.name}: ${error?.message}\n`);
|
|
616
|
-
reply(id, toolResult('
|
|
616
|
+
reply(id, toolResult('This MCP server hit an unexpected error.', true));
|
|
617
617
|
}
|
|
618
618
|
}
|
|
619
619
|
return;
|