god-prompt-mcp 1.0.3

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.
Files changed (6) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +121 -0
  3. package/dist/content.js +2286 -0
  4. package/dist/server.js +216 -0
  5. package/dist/stdio.js +7 -0
  6. package/package.json +66 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AKzar1el
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,121 @@
1
+ # GodPrompt MCP Server
2
+
3
+ A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for [GodPrompt](https://github.com/AKzar1el/god-prompt) — AI software-development workflow guidance with task routing, TDD, debugging protocols, verification gates, and progressive disclosure.
4
+
5
+ ## Tools
6
+
7
+ | Tool | Description |
8
+ |------|-------------|
9
+ | `get_god_prompt` | Full GodPrompt.md single-file payload (~40KB) |
10
+ | `get_core_skill` | `SKILL.md` — always-on protocol (~10KB) |
11
+ | `get_protocols` | `references/01-PROTOCOLS.md` — deep execution guides (~13KB) |
12
+ | `get_gates` | `references/02-GATES.md` — verification checklists (~9KB) |
13
+ | `get_anti_patterns` | `references/03-ANTI-PATTERNS.md` — red flags & recovery (~9KB) |
14
+ | `classify_task` | Classify a task into one of 9 GodPrompt task types |
15
+ | `get_version` | Version info and server metadata |
16
+
17
+ ## Progressive Disclosure
18
+
19
+ For minimum context usage, start with `get_core_skill`, then load `get_protocols`, `get_gates`, or `get_anti_patterns` only when the task requires deeper guidance. Use `get_god_prompt` when you want everything in one shot.
20
+
21
+ ## Example queries
22
+
23
+ - "Classify this refactor and tell me which GodPrompt workflow applies."
24
+ - "Show me the verification gates I should satisfy before I claim this bug fix is complete."
25
+ - "Load the debugging protocol for a failing integration test without loading the full GodPrompt."
26
+
27
+ ## Evaluation
28
+
29
+ GodPrompt's benchmark methodology, deterministic task corpus, evaluator logic, and published run artifacts live in the source project: [GodPrompt Bench](https://github.com/AKzar1el/god-prompt/tree/main/bench).
30
+
31
+ The MCP server does not run the benchmark or claim model-level superiority itself; it distributes the GodPrompt content evaluated by that suite.
32
+
33
+ ## Connect
34
+
35
+ ### npm / npx (recommended)
36
+
37
+ ```bash
38
+ npx -y god-prompt-mcp
39
+ ```
40
+
41
+ The public npm package runs the local stdio server directly. It requires Node.js 20+ and no API key or account.
42
+
43
+ ### Glama
44
+
45
+ GodPrompt MCP is published on [Glama](https://glama.ai/mcp/servers/AKzar1el/god-prompt-mcp). Use the server page to inspect the tools and connect it to a supported MCP client.
46
+
47
+ ### Kiro
48
+
49
+ [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=god-prompt-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22god-prompt-mcp%22%5D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D)
50
+
51
+ Kiro launches the published npm package through `npx`. Node.js 20+ is required.
52
+
53
+ ### Cursor
54
+
55
+ The repository includes a Cursor plugin manifest and `mcp.json` for Marketplace or local plugin installation. Cursor runs the same local stdio server through `npx -y god-prompt-mcp`.
56
+
57
+ ### Claude Desktop extension
58
+
59
+ GitHub releases include a `.mcpb` bundle for one-click local installation in MCPB-compatible clients such as Claude Desktop. The bundle runs the same local stdio server and does not require an API key or account.
60
+
61
+ ### Local stdio
62
+
63
+ ```bash
64
+ npm install
65
+ npm run build
66
+ node dist/stdio.js
67
+ ```
68
+
69
+ Example client configuration:
70
+
71
+ ```json
72
+ {
73
+ "mcpServers": {
74
+ "god-prompt": {
75
+ "command": "node",
76
+ "args": ["/absolute/path/to/god-prompt-mcp/dist/stdio.js"]
77
+ }
78
+ }
79
+ }
80
+ ```
81
+
82
+ ## Privacy Policy
83
+
84
+ GodPrompt MCP is a local stdio server. Its content tools return static GodPrompt material bundled with the installed extension, and `classify_task` evaluates the supplied task description in the local Node.js process.
85
+
86
+ - **Data collection and use:** the server has no telemetry or analytics and does not collect account data. Tool input is used only to produce the requested local response.
87
+ - **Storage and retention:** the server has no server-side persistence and does not retain tool inputs after a request completes.
88
+ - **Third-party sharing:** the server does not transmit tool inputs or bundled GodPrompt content to an external API or third party. The MCP host or AI client may process conversation and tool data under its own policies independently of this server.
89
+ - **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).
90
+
91
+ ## Development
92
+
93
+ ```bash
94
+ npm install
95
+ npm run build
96
+ npm test
97
+ ```
98
+
99
+ `npm test` builds the stdio server, performs the MCP initialization handshake, and verifies the expected tool list.
100
+
101
+ Repository discovery metadata is kept in `server.json` for MCP Registry-compatible consumers and `glama.json` for Glama.
102
+
103
+ ## Updating Content
104
+
105
+ To update the embedded GodPrompt content:
106
+
107
+ 1. Pull the latest content from the [GodPrompt repository](https://github.com/AKzar1el/god-prompt).
108
+ 2. Run `npm run generate-content`.
109
+ 3. Run `npm test` before publishing a new server release.
110
+
111
+ The generator reads the current source layout: `GodPrompt.md`, `SKILL.md`, and the three files under `references/`.
112
+
113
+ ## License
114
+
115
+ [MIT](LICENSE)
116
+
117
+ ## Project & related MCP servers
118
+
119
+ Project page: [GodPrompt — AI software-development system prompt](https://tomiseregi.si/projects/god-prompt) · [GodPrompt source](https://github.com/AKzar1el/god-prompt)
120
+
121
+ Related MCP servers: [Google Search Console](https://github.com/AKzar1el/mcp-gsc) · [GEO Tracker](https://github.com/AKzar1el/mcp-geo) · [Web Validator](https://github.com/AKzar1el/mcp-web-validator) · [Google News & Trends](https://github.com/AKzar1el/mcp-trendpulse)