god-prompt-mcp 1.0.21 → 1.0.23
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 +36 -10
- package/dist/server.js +3 -8
- package/dist/skill-content.js +8 -0
- package/dist/skills.js +125 -0
- package/dist/stdio.js +4 -2
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -40,6 +40,32 @@ The MCP server does not run the benchmark or claim model-level superiority itsel
|
|
|
40
40
|
|
|
41
41
|
## Connect
|
|
42
42
|
|
|
43
|
+
### Hosted remote (no Node.js required)
|
|
44
|
+
|
|
45
|
+
Use the public Streamable HTTP endpoint directly in MCP clients that support remote servers:
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
The hosted endpoint exposes the same seven read-only GodPrompt tools as the local server and requires no API key or local Node.js runtime. It accepts both the deployed `initialize` flow and the current MCP 2026-07-28 `server/discover` flow so clients can connect while the ecosystem transitions between protocol eras. It is also published as a remote option in the Official MCP Registry alongside the installable stdio packages.
|
|
52
|
+
|
|
53
|
+
### Agent Skills over MCP (SEP-2640)
|
|
54
|
+
|
|
55
|
+
On MCP 2026-07-28, both the hosted and stdio servers advertise the Final `io.modelcontextprotocol/skills` extension from SEP-2640. Supporting clients can discover the same relevance-scoped `god-prompt` Agent Skill with `skills/list` / `skills/get`, then fetch `SKILL.md` and its three reference files through `resources/read`. The skill manifest includes SHA-256 digests and exact byte sizes so clients can verify what they import. Clients that do not implement this extension continue to use the seven existing GodPrompt tools normally.
|
|
56
|
+
|
|
57
|
+
This transports GodPrompt's existing skill package; it does not force the skill into every request or change the host's own approval, verification, or activation policy. See the [MCP Skills extension specification](https://modelcontextprotocol.io/extensions/skills/overview).
|
|
58
|
+
|
|
59
|
+
### ChatGPT (hosted remote)
|
|
60
|
+
|
|
61
|
+
On ChatGPT web, supported Business and Enterprise/Edu workspaces can connect the hosted endpoint as a custom MCP app in Developer Mode:
|
|
62
|
+
|
|
63
|
+
1. Enable Developer Mode, then open **Settings > Apps > Create** (workspace controls may require an admin or authorized developer).
|
|
64
|
+
2. Use `https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp` as the MCP endpoint and select no authentication.
|
|
65
|
+
3. Choose **Scan Tools**, confirm the seven read-only GodPrompt tools, then create and enable the app for the intended workspace users.
|
|
66
|
+
|
|
67
|
+
ChatGPT connects to remote MCP servers rather than local stdio servers. See OpenAI's [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) documentation for current availability and workspace controls.
|
|
68
|
+
|
|
43
69
|
### npm / npx (recommended)
|
|
44
70
|
|
|
45
71
|
```bash
|
|
@@ -180,7 +206,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent droi
|
|
|
180
206
|
Droid discovers compatible project skills under `.agents/skills/`. To add the callable GodPrompt tools as a local stdio MCP server, use Droid's native MCP command with the published version pinned:
|
|
181
207
|
|
|
182
208
|
```bash
|
|
183
|
-
droid mcp add god-prompt "npx -y god-prompt-mcp@1.0.
|
|
209
|
+
droid mcp add god-prompt "npx -y god-prompt-mcp@1.0.23"
|
|
184
210
|
```
|
|
185
211
|
|
|
186
212
|
Open `/mcp` in Droid to verify the server and available tools. The Agent Skill supplies the reusable workflow while MCP exposes GodPrompt's seven progressive-disclosure tools. Node.js 22+ is required for the MCP server.
|
|
@@ -206,7 +232,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent goos
|
|
|
206
232
|
Goose discovers the copied skill under `.goose/skills/god-prompt/`. To expose GodPrompt's callable tools for a session, start Goose with the published MCP package as an external stdio extension:
|
|
207
233
|
|
|
208
234
|
```bash
|
|
209
|
-
goose session --with-extension "npx -y god-prompt-mcp@1.0.
|
|
235
|
+
goose session --with-extension "npx -y god-prompt-mcp@1.0.23"
|
|
210
236
|
```
|
|
211
237
|
|
|
212
238
|
Goose currently treats Agent Skills and MCP extensions as separate native surfaces, so this path does not depend on Agent Plugins support. The skill supplies the reusable workflow while MCP exposes GodPrompt's seven progressive-disclosure tools. Node.js 22+ is required for the MCP server.
|
|
@@ -264,7 +290,7 @@ The Trae target installs the skill under `.trae/skills/god-prompt/`, where TraeC
|
|
|
264
290
|
"mcpServers": {
|
|
265
291
|
"god-prompt": {
|
|
266
292
|
"command": "npx",
|
|
267
|
-
"args": ["-y", "god-prompt-mcp@1.0.
|
|
293
|
+
"args": ["-y", "god-prompt-mcp@1.0.23"]
|
|
268
294
|
}
|
|
269
295
|
}
|
|
270
296
|
}
|
|
@@ -283,7 +309,7 @@ npx -y skills@latest add AKzar1el/god-prompt-mcp --skill god-prompt --agent open
|
|
|
283
309
|
The copied skill lands under `.agents/skills/god-prompt/`, one of OpenClaw's documented project skill roots. To expose GodPrompt's callable tools to OpenClaw-managed agent runtimes as well, register the published stdio server:
|
|
284
310
|
|
|
285
311
|
```bash
|
|
286
|
-
openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.0.
|
|
312
|
+
openclaw mcp add god-prompt --command npx --arg -y --arg god-prompt-mcp@1.0.23
|
|
287
313
|
openclaw mcp probe god-prompt
|
|
288
314
|
```
|
|
289
315
|
|
|
@@ -304,7 +330,7 @@ The Qoder target installs the skill under `.qoder/skills/god-prompt/`, where Qod
|
|
|
304
330
|
"mcpServers": {
|
|
305
331
|
"god-prompt": {
|
|
306
332
|
"command": "npx",
|
|
307
|
-
"args": ["-y", "god-prompt-mcp@1.0.
|
|
333
|
+
"args": ["-y", "god-prompt-mcp@1.0.23"]
|
|
308
334
|
}
|
|
309
335
|
}
|
|
310
336
|
}
|
|
@@ -344,7 +370,7 @@ Kimi Code CLI can install GodPrompt as one native custom plugin containing the e
|
|
|
344
370
|
/reload
|
|
345
371
|
```
|
|
346
372
|
|
|
347
|
-
The Kimi manifest points at `skills/`, so the `god-prompt` skill remains available through Kimi's normal relevance-based skill loading instead of being forced into every session. The same manifest exposes `god-prompt-mcp@1.0.
|
|
373
|
+
The Kimi manifest points at `skills/`, so the `god-prompt` skill remains available through Kimi's normal relevance-based skill loading instead of being forced into every session. The same manifest exposes `god-prompt-mcp@1.0.23` as a local stdio MCP server, preserving the seven progressive-disclosure tools. The explicit `tree/main` URL matters because Kimi's bare GitHub-repository install form prefers the latest GitHub release; using `main` makes the current plugin manifest available without forcing a documentation-only npm/MCP Registry release. Node.js 22+ is required for the MCP server.
|
|
348
374
|
|
|
349
375
|
### JetBrains AI Assistant
|
|
350
376
|
|
|
@@ -461,11 +487,11 @@ Example client configuration:
|
|
|
461
487
|
|
|
462
488
|
## Privacy Policy
|
|
463
489
|
|
|
464
|
-
GodPrompt MCP
|
|
490
|
+
GodPrompt MCP can run either as a local stdio server or through the public Streamable HTTP Worker. Its content tools return static GodPrompt material bundled with the server, and `classify_task` is deterministic; neither mode calls a model or third-party content API.
|
|
465
491
|
|
|
466
|
-
- **Data collection and use:**
|
|
467
|
-
- **Storage and retention:** the
|
|
468
|
-
- **Third-party sharing:**
|
|
492
|
+
- **Data collection and use:** GodPrompt application code has no telemetry or analytics and does not request account data. Local stdio tool input stays in the local Node.js process. Hosted remote tool input is sent over HTTPS to the Cloudflare-hosted Worker so it can produce the MCP response.
|
|
493
|
+
- **Storage and retention:** the MCP request handlers are stateless and have no application database or request-retention path; they do not intentionally persist tool inputs after a request completes. Hosting/provider infrastructure may process connection or request metadata under its own policies.
|
|
494
|
+
- **Third-party sharing:** local stdio does not transmit tool inputs or bundled GodPrompt content to an external API. The hosted remote necessarily passes the request through Cloudflare infrastructure, but GodPrompt application code does not forward tool inputs to another API or service. The MCP host or AI client may process conversation and tool data under its own policies independently of this server.
|
|
469
495
|
- **Contact and policy:** see [tomiseregi.si/privacy](https://tomiseregi.si/privacy) for the current privacy policy and contact information. For support or bug reports, use [GitHub Issues](https://github.com/AKzar1el/god-prompt-mcp/issues).
|
|
470
496
|
|
|
471
497
|
## Development
|
package/dist/server.js
CHANGED
|
@@ -1,16 +1,11 @@
|
|
|
1
1
|
import * as z from "zod/v4";
|
|
2
2
|
import { CONTENT, VERSION } from "./content.js";
|
|
3
|
+
import { CORE_SKILL } from "./skill-content.js";
|
|
3
4
|
export const SERVER_INFO = {
|
|
4
5
|
name: "god-prompt-mcp",
|
|
5
|
-
version: "1.0.
|
|
6
|
+
version: "1.0.23",
|
|
6
7
|
};
|
|
7
|
-
|
|
8
|
-
// SKILL.md + references/*. Normalize only those legacy links at the serving
|
|
9
|
-
// boundary; regenerated content from the repaired generator makes this a no-op.
|
|
10
|
-
const CORE_SKILL = CONTENT.CORE_SKILL
|
|
11
|
-
.replaceAll("core/01-PROTOCOLS.md", "references/01-PROTOCOLS.md")
|
|
12
|
-
.replaceAll("core/02-GATES.md", "references/02-GATES.md")
|
|
13
|
-
.replaceAll("core/03-ANTI-PATTERNS.md", "references/03-ANTI-PATTERNS.md");
|
|
8
|
+
export const SERVER_INSTRUCTIONS = "Start with get_core_skill for the lean GodPrompt protocol. Use classify_task to route a concrete task, then load get_protocols, get_gates, or get_anti_patterns only when that focused reference is needed. Use get_god_prompt only when the full single-file payload is preferable. All GodPrompt tools are read-only.";
|
|
14
9
|
const READ_ONLY_ANNOTATIONS = {
|
|
15
10
|
readOnlyHint: true,
|
|
16
11
|
destructiveHint: false,
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { CONTENT } from "./content.js";
|
|
2
|
+
// Version 1.0.0 was generated before the source layout moved from core/* to
|
|
3
|
+
// SKILL.md + references/*. Normalize only those legacy links at the serving
|
|
4
|
+
// boundary; regenerated content from the repaired generator makes this a no-op.
|
|
5
|
+
export const CORE_SKILL = CONTENT.CORE_SKILL
|
|
6
|
+
.replaceAll("core/01-PROTOCOLS.md", "references/01-PROTOCOLS.md")
|
|
7
|
+
.replaceAll("core/02-GATES.md", "references/02-GATES.md")
|
|
8
|
+
.replaceAll("core/03-ANTI-PATTERNS.md", "references/03-ANTI-PATTERNS.md");
|
package/dist/skills.js
ADDED
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import * as z from "zod/v4";
|
|
2
|
+
import { CONTENT } from "./content.js";
|
|
3
|
+
import { CORE_SKILL } from "./skill-content.js";
|
|
4
|
+
const EXTENSION_ID = "io.modelcontextprotocol/skills";
|
|
5
|
+
const SKILL_URI = "skill://god-prompt/SKILL.md";
|
|
6
|
+
const CACHE_TTL_MS = 300_000;
|
|
7
|
+
const SKILL_FILES = [
|
|
8
|
+
{ uri: SKILL_URI, text: CORE_SKILL },
|
|
9
|
+
{
|
|
10
|
+
uri: "skill://god-prompt/references/01-PROTOCOLS.md",
|
|
11
|
+
text: CONTENT.PROTOCOLS,
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
uri: "skill://god-prompt/references/02-GATES.md",
|
|
15
|
+
text: CONTENT.GATES,
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
uri: "skill://god-prompt/references/03-ANTI-PATTERNS.md",
|
|
19
|
+
text: CONTENT.ANTI_PATTERNS,
|
|
20
|
+
},
|
|
21
|
+
];
|
|
22
|
+
function parseFrontmatter(skill) {
|
|
23
|
+
const normalized = skill.replaceAll("\r\n", "\n");
|
|
24
|
+
const match = /^---\n([\s\S]*?)\n---(?:\n|$)/.exec(normalized);
|
|
25
|
+
if (!match)
|
|
26
|
+
throw new Error("GodPrompt SKILL.md is missing YAML frontmatter");
|
|
27
|
+
const lines = match[1].split("\n");
|
|
28
|
+
const frontmatter = {};
|
|
29
|
+
for (let index = 0; index < lines.length; index += 1) {
|
|
30
|
+
const line = lines[index];
|
|
31
|
+
if (!line.trim())
|
|
32
|
+
continue;
|
|
33
|
+
const scalar = /^(name|license):\s*(.+)$/.exec(line);
|
|
34
|
+
if (scalar) {
|
|
35
|
+
frontmatter[scalar[1]] = scalar[2].trim();
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
if (line === "description: |") {
|
|
39
|
+
const description = [];
|
|
40
|
+
while (index + 1 < lines.length && lines[index + 1].startsWith(" ")) {
|
|
41
|
+
index += 1;
|
|
42
|
+
description.push(lines[index].slice(2));
|
|
43
|
+
}
|
|
44
|
+
frontmatter.description = `${description.join("\n")}\n`;
|
|
45
|
+
continue;
|
|
46
|
+
}
|
|
47
|
+
throw new Error(`Unsupported GodPrompt SKILL.md frontmatter line: ${line}`);
|
|
48
|
+
}
|
|
49
|
+
if (!frontmatter.name || !frontmatter.description) {
|
|
50
|
+
throw new Error("GodPrompt SKILL.md frontmatter must include name and description");
|
|
51
|
+
}
|
|
52
|
+
return frontmatter;
|
|
53
|
+
}
|
|
54
|
+
const SKILL_FRONTMATTER = parseFrontmatter(CORE_SKILL);
|
|
55
|
+
async function sha256(text) {
|
|
56
|
+
const bytes = new TextEncoder().encode(text);
|
|
57
|
+
const digest = await crypto.subtle.digest("SHA-256", bytes);
|
|
58
|
+
const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
59
|
+
return `sha256:${hex}`;
|
|
60
|
+
}
|
|
61
|
+
async function buildSkillEntry() {
|
|
62
|
+
return {
|
|
63
|
+
uri: SKILL_URI,
|
|
64
|
+
frontmatter: SKILL_FRONTMATTER,
|
|
65
|
+
resources: await Promise.all(SKILL_FILES.map(async ({ uri, text }) => ({
|
|
66
|
+
uri,
|
|
67
|
+
digest: await sha256(text),
|
|
68
|
+
size: new TextEncoder().encode(text).byteLength,
|
|
69
|
+
}))),
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
const listSkillsParams = z.object({
|
|
73
|
+
cursor: z.string().optional(),
|
|
74
|
+
});
|
|
75
|
+
const getSkillParams = z.object({
|
|
76
|
+
uri: z.string(),
|
|
77
|
+
});
|
|
78
|
+
export function registerGodPromptSkillExtension(server) {
|
|
79
|
+
for (const { uri, text } of SKILL_FILES) {
|
|
80
|
+
const isRootSkill = uri === SKILL_URI;
|
|
81
|
+
server.registerResource(isRootSkill ? "god-prompt" : uri.slice("skill://god-prompt/".length), uri, {
|
|
82
|
+
mimeType: "text/markdown",
|
|
83
|
+
...(isRootSkill
|
|
84
|
+
? {
|
|
85
|
+
description: SKILL_FRONTMATTER.description.trim(),
|
|
86
|
+
}
|
|
87
|
+
: {}),
|
|
88
|
+
}, async (resourceUri) => ({
|
|
89
|
+
contents: [
|
|
90
|
+
{
|
|
91
|
+
uri: resourceUri.href,
|
|
92
|
+
mimeType: "text/markdown",
|
|
93
|
+
text,
|
|
94
|
+
},
|
|
95
|
+
],
|
|
96
|
+
}));
|
|
97
|
+
}
|
|
98
|
+
server.server.registerCapabilities({
|
|
99
|
+
extensions: {
|
|
100
|
+
[EXTENSION_ID]: {},
|
|
101
|
+
},
|
|
102
|
+
});
|
|
103
|
+
server.server.setRequestHandler("skills/list", { params: listSkillsParams }, async ({ cursor }) => {
|
|
104
|
+
if (cursor !== undefined) {
|
|
105
|
+
throw new Error("GodPrompt serves one skills/list page and does not issue cursors");
|
|
106
|
+
}
|
|
107
|
+
return {
|
|
108
|
+
resultType: "complete",
|
|
109
|
+
skills: [await buildSkillEntry()],
|
|
110
|
+
ttlMs: CACHE_TTL_MS,
|
|
111
|
+
cacheScope: "public",
|
|
112
|
+
};
|
|
113
|
+
});
|
|
114
|
+
server.server.setRequestHandler("skills/get", { params: getSkillParams }, async ({ uri }) => {
|
|
115
|
+
if (uri !== SKILL_URI) {
|
|
116
|
+
throw new Error(`Unknown GodPrompt skill URI: ${uri}`);
|
|
117
|
+
}
|
|
118
|
+
return {
|
|
119
|
+
resultType: "complete",
|
|
120
|
+
skill: await buildSkillEntry(),
|
|
121
|
+
ttlMs: CACHE_TTL_MS,
|
|
122
|
+
cacheScope: "public",
|
|
123
|
+
};
|
|
124
|
+
});
|
|
125
|
+
}
|
package/dist/stdio.js
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { McpServer } from "@modelcontextprotocol/server";
|
|
3
3
|
import { serveStdio } from "@modelcontextprotocol/server/stdio";
|
|
4
|
-
import { registerGodPromptTools, SERVER_INFO } from "./server.js";
|
|
4
|
+
import { registerGodPromptTools, SERVER_INFO, SERVER_INSTRUCTIONS, } from "./server.js";
|
|
5
|
+
import { registerGodPromptSkillExtension } from "./skills.js";
|
|
5
6
|
function createServer() {
|
|
6
|
-
const server = new McpServer(SERVER_INFO);
|
|
7
|
+
const server = new McpServer(SERVER_INFO, { instructions: SERVER_INSTRUCTIONS });
|
|
7
8
|
registerGodPromptTools(server);
|
|
9
|
+
registerGodPromptSkillExtension(server);
|
|
8
10
|
return server;
|
|
9
11
|
}
|
|
10
12
|
await serveStdio(createServer);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "god-prompt-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.23",
|
|
4
4
|
"mcpName": "io.github.AKzar1el/god-prompt-mcp",
|
|
5
5
|
"description": "MCP server for GodPrompt — the universal AI software development system prompt",
|
|
6
6
|
"private": false,
|
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
"files": [
|
|
10
10
|
"dist/stdio.js",
|
|
11
11
|
"dist/server.js",
|
|
12
|
+
"dist/skill-content.js",
|
|
13
|
+
"dist/skills.js",
|
|
12
14
|
"dist/content.js",
|
|
13
15
|
"README.md",
|
|
14
16
|
"LICENSE"
|