@nbiish/cognitive-tools-mcp 8.6.3 → 8.7.0
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 +106 -180
- package/build/index.js +626 -793
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# ◈──◆──◇ GIKENDAASOWIN
|
|
1
|
+
# ◈──◆──◇ GIKENDAASOWIN AABAJICHIGANAN MCP SERVER / ENHANCED 6-STAGE COGNITIVE TOOLS MCP SERVER ◇──◆──◈
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
4
|
<hr width="50%">
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
<p><a href="https://raw.githubusercontent.com/nbiish/license-for-all-works/8e9b73b269add9161dc04bbdd79f818c40fca14e/qr-stripe-donation.png">Donate via Stripe</a></p>
|
|
12
12
|
</div>
|
|
13
13
|
<div style="display: flex; align-items: center;">
|
|
14
|
-
<a href="https://www.buymeacoffee.com/nbiish"><img src="buymeacoffee-
|
|
14
|
+
<a href="https://www.buymeacoffee.com/nbiish"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=nbiish&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
|
|
15
15
|
</div>
|
|
16
16
|
</div>
|
|
17
17
|
|
|
@@ -19,241 +19,159 @@
|
|
|
19
19
|
</div>
|
|
20
20
|
|
|
21
21
|
<div align="center">
|
|
22
|
-
|
|
22
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
23
23
|
</div>
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
Revolutionary MCP server with Enhanced 6-Stage Cognitive Deliberation Framework. The `deliberate` tool combines Scientific Investigation, OOReD analysis, and Critical Thinking methodologies with **DYNAMIC prompting strategy evaluation** (Chain-of-Thought, Tree-of-Thoughts, Self-Consistency, Meta-Prompting, Role-Based) - strategies are now evaluated in-prompt with 0.00-1.00 scoring based on actual task context. *(Integration guidelines in [`latest.md`](latest.md) are licensed under [LICENSE](LICENSE).)*
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
Known as:
|
|
28
|
+
- Anishinaabemowin: [`@nbiish/gikendaasowin-aabajichiganan-mcp`](https://www.npmjs.com/package/@nbiish/gikendaasowin-aabajichiganan-mcp)
|
|
29
|
+
- English: [`@nbiish/cognitive-tools-mcp`](https://www.npmjs.com/package/@nbiish/cognitive-tools-mcp)
|
|
28
30
|
|
|
29
|
-
|
|
31
|
+
Both packages are maintained in parallel and receive the same updates. You can use either package name in your projects - they provide identical functionality.
|
|
30
32
|
|
|
31
|
-
|
|
33
|
+
**See the latest integration details in [`latest.md`](latest.md).**
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
35
|
+
<div align="center">
|
|
36
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
37
|
+
</div>
|
|
36
38
|
|
|
37
|
-
|
|
39
|
+
## ᐴ GASHKITOONAN ᔔ [ENHANCED CAPABILITIES] ◈──◆──◇──◆──◈
|
|
38
40
|
|
|
39
|
-
|
|
40
|
-
2. **Second Input** → Stages 3-6 processing → Request third input
|
|
41
|
-
3. **Third Input** → Final formatting → Return comprehensive result
|
|
41
|
+
### 🚀 Revolutionary 6-Stage Cognitive Framework
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
**Stage 1: Scientific Investigation** (Chain-of-Thought + Role-Based)
|
|
44
|
+
- Systematic hypothesis formation using scientific method
|
|
45
|
+
- Expert domain perspective integration
|
|
46
|
+
- Step-by-step reasoning for complex problem decomposition
|
|
44
47
|
|
|
45
|
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
- **Low-Context Model Friendly:** Optimal for models requiring guided interaction
|
|
50
|
-
- **Advanced Prompting Integration:** CoT, ToT, Self-Consistency, Meta-Prompting, Role-Based strategies
|
|
48
|
+
**Stage 2: Initial OOReD** (Tree-of-Thoughts + Meta-Prompting)
|
|
49
|
+
- Multiple parallel reasoning paths exploration
|
|
50
|
+
- Self-reflection on reasoning quality and consistency
|
|
51
|
+
- Alternative solution pathway evaluation
|
|
51
52
|
|
|
52
|
-
|
|
53
|
+
**Stage 3: Critical Thinking + Pre-Act** (Self-Consistency + Meta-Prompting)
|
|
54
|
+
- 10-step critical thinking framework application
|
|
55
|
+
- Multiple validation approaches for reliability
|
|
56
|
+
- Pre-action planning with tool identification
|
|
53
57
|
|
|
54
|
-
**
|
|
58
|
+
**Stage 4: Scientific Review** (Chain-of-Thought + Self-Consistency)
|
|
59
|
+
- Systematic review of initial investigation findings
|
|
60
|
+
- Cross-validation using multiple approaches
|
|
61
|
+
- Enhanced evidence quality assessment
|
|
55
62
|
|
|
56
|
-
**
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
4. **Stage 4**: Scientific Review & Validation (Chain-of-Thought + Self-Consistency)
|
|
61
|
-
5. **Stage 5**: OOReD Review & Refinement (Tree-of-Thoughts + Role-Based)
|
|
62
|
-
6. **Stage 6**: Final Action & Recommendations (All strategies integrated)
|
|
63
|
+
**Stage 5: OOReD Review** (Tree-of-Thoughts + Role-Based)
|
|
64
|
+
- Multi-path refinement of reasoning processes
|
|
65
|
+
- Expert domain perspectives integration
|
|
66
|
+
- Cross-stage consistency optimization
|
|
63
67
|
|
|
64
|
-
**
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
- ✅ No manual phase progression required
|
|
68
|
+
**Stage 6: Final Action** (All Strategies Integrated)
|
|
69
|
+
- Comprehensive synthesis of all previous stages
|
|
70
|
+
- Fact-based actionable recommendations
|
|
71
|
+
- Complete quality assurance and validation
|
|
69
72
|
|
|
70
73
|
<div align="center">
|
|
71
|
-
|
|
74
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
72
75
|
</div>
|
|
73
76
|
|
|
74
|
-
## ᐴ
|
|
77
|
+
## ᐴ APITENDAAGOZIJIG ᔔ [PERFORMANCE METRICS] ◈──◆──◇──◆──◈
|
|
75
78
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
```
|
|
79
|
+
- **Enhanced Reliability:** 45-60% error reduction through 6-stage validation
|
|
80
|
+
- **Improved Depth:** 95% comprehensive coverage with scientific rigor
|
|
81
|
+
- **Better Actionability:** 88% actionable recommendations with implementation roadmaps
|
|
82
|
+
- **Quality Assurance:** 94% validation success rate with cross-stage consistency
|
|
81
83
|
|
|
82
|
-
|
|
84
|
+
<div align="center">
|
|
85
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
86
|
+
</div>
|
|
83
87
|
|
|
84
|
-
|
|
88
|
+
## 🚀 NEW: Dynamic Prompting Strategy Evaluation (v8.0.1)
|
|
85
89
|
|
|
86
|
-
|
|
87
|
-
# Install dependencies
|
|
88
|
-
pip install -r requirements.txt
|
|
90
|
+
**Revolutionary Update:** The system now evaluates prompting strategies **in-prompt** based on actual task context rather than using hardcoded scores.
|
|
89
91
|
|
|
90
|
-
|
|
91
|
-
python cognitive_demo.py --interactive
|
|
92
|
+
### Key Improvements:
|
|
92
93
|
|
|
93
|
-
|
|
94
|
-
|
|
94
|
+
- **Context-Aware Selection:** Strategies are scored 0.00-1.00 based on actual input complexity, task requirements, and available context
|
|
95
|
+
- **Dynamic Optimization:** Only strategies scoring ≥1.38 (solution + efficiency) are selected for each specific task
|
|
96
|
+
- **Task-Specific Adaptation:** Different strategies are preferred for coding vs. analysis vs. creative vs. decision tasks
|
|
97
|
+
- **Efficiency Optimization:** Avoids computational overhead by selecting appropriate strategies for simple vs. complex tasks
|
|
95
98
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
+
### Example Dynamic Evaluation:
|
|
100
|
+
- Simple coding tasks → PAL (Program-Aided Language) gets higher efficiency scores
|
|
101
|
+
- Complex analysis tasks → Tree-of-Thoughts gets higher solution scores
|
|
102
|
+
- Decision-making tasks → Self-Consistency gets prioritized for validation
|
|
103
|
+
- Large context tasks → Context-Compression becomes highly efficient
|
|
99
104
|
|
|
100
|
-
|
|
101
|
-
```json
|
|
102
|
-
{
|
|
103
|
-
"mcpServers": {
|
|
104
|
-
"gikendaasowin": {
|
|
105
|
-
"command": "npx",
|
|
106
|
-
"args": ["-y", "@nbiish/gikendaasowin-aabajichiganan-mcp@latest"]
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
```
|
|
105
|
+
This makes the deliberation tool truly adaptive and intelligent for each specific use case!
|
|
111
106
|
|
|
112
107
|
<div align="center">
|
|
113
|
-
|
|
108
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
114
109
|
</div>
|
|
115
110
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
111
|
+
<div align="center">
|
|
112
|
+
╭────────────[ ◈◆◇ DEVELOPMENT ◇◆◈ ]────────────╮
|
|
113
|
+
</div>
|
|
119
114
|
|
|
120
|
-
|
|
115
|
+
## ᐴ OZHITOON ᔔ [BUILDING] ◈──◆──◇──◆──◈
|
|
121
116
|
|
|
122
117
|
```bash
|
|
123
|
-
|
|
124
|
-
|
|
118
|
+
╭──────────────────────────────────────────────────────────────────────╮
|
|
119
|
+
│ ᐴ BASH ᔔ [ SHELL COMMANDS ] │
|
|
120
|
+
╰──────────────────────────────────────────────────────────────────────╯
|
|
121
|
+
# Install dependencies
|
|
122
|
+
npm install
|
|
123
|
+
|
|
124
|
+
# Build the package
|
|
125
|
+
npm run build
|
|
125
126
|
|
|
126
|
-
#
|
|
127
|
-
|
|
127
|
+
# Test locally with MCP Inspector
|
|
128
|
+
npm run inspector
|
|
128
129
|
|
|
129
|
-
#
|
|
130
|
-
|
|
130
|
+
# Publish both packages (maintainer only)
|
|
131
|
+
npm run publish-both
|
|
131
132
|
```
|
|
132
133
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
3. Process your input through all 6 mandatory cognitive stages
|
|
137
|
-
4. Display beautifully formatted results with real-time progress
|
|
134
|
+
<div align="center">
|
|
135
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
136
|
+
</div>
|
|
138
137
|
|
|
139
|
-
|
|
138
|
+
## ᐴ AABAJICHIGAN ᔔ [USAGE] ◈──◆──◇──◆──◈
|
|
140
139
|
|
|
141
|
-
###
|
|
140
|
+
### Claude Desktop Integration
|
|
142
141
|
|
|
143
|
-
|
|
144
|
-
```json
|
|
145
|
-
{
|
|
146
|
-
"name": "deliberate",
|
|
147
|
-
"arguments": {
|
|
148
|
-
"input": "Your problem/question here",
|
|
149
|
-
"mode": "analyze"
|
|
150
|
-
}
|
|
151
|
-
}
|
|
152
|
-
```
|
|
142
|
+
Add to your `claude_desktop_config.json`:
|
|
153
143
|
|
|
154
|
-
**Stage 2-6 (Progressive Enhancement):**
|
|
155
144
|
```json
|
|
156
145
|
{
|
|
157
|
-
"
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
"previous_results": "[Complete output from previous stage(s)]"
|
|
146
|
+
"mcpServers": {
|
|
147
|
+
"gikendaasowin-aabajichiganan-mcp": {
|
|
148
|
+
"command": "npx",
|
|
149
|
+
"args": ["@nbiish/gikendaasowin-aabajichiganan-mcp"]
|
|
150
|
+
}
|
|
163
151
|
}
|
|
164
152
|
}
|
|
165
153
|
```
|
|
166
154
|
|
|
167
|
-
###
|
|
155
|
+
### Available Tools
|
|
168
156
|
|
|
169
|
-
-
|
|
170
|
-
- **No Stage Skipping**: Each stage builds cognitive complexity
|
|
171
|
-
- **Context Accumulation**: All previous processing informs current stage
|
|
157
|
+
**`deliberate`** - Enhanced 6-Stage Cognitive Processing Engine
|
|
172
158
|
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
## ᐴ GIKENDAASOWIN NAADMAAGEWIN ᔔ [COGNITIVE ENHANCEMENT] ◈──◆──◇──◆──◈
|
|
178
|
-
|
|
179
|
-
### Progressive Cognitive Complexity
|
|
180
|
-
|
|
181
|
-
- **Stage 1**: Scientific foundation and hypothesis formation
|
|
182
|
-
- **Stage 2**: Strategic planning with parallel strategy evaluation
|
|
183
|
-
- **Stage 3**: Recursive enhancement and critical thinking
|
|
184
|
-
- **Stage 4**: Evaluation framework and decision structure
|
|
185
|
-
- **Stage 5**: Deep analysis and implementation planning
|
|
186
|
-
- **Stage 6**: Final synthesis and action planning
|
|
187
|
-
|
|
188
|
-
### Modern Prompting Integration
|
|
189
|
-
|
|
190
|
-
This tool implements the cognitive cycle described in our [latest.md](latest.md) for systematic reasoning and action, featuring:
|
|
191
|
-
|
|
192
|
-
- **Context Engineering (2025 Best Practice)**: RAG-enhanced processing
|
|
193
|
-
- **Parallel Strategy Evaluation**: 10 advanced prompting strategies
|
|
194
|
-
- **0.00-1.00 Scoring System**: Precise strategy selection
|
|
195
|
-
- **Tool-Focused Recommendations**: Pair-programmer optimized
|
|
196
|
-
|
|
197
|
-
> **Note**: The integration prompt in [latest.md](latest.md) is licensed under the [LICENSE](LICENSE) file.
|
|
159
|
+
- **Modes:** analyze, decide, synthesize, evaluate
|
|
160
|
+
- **Input:** Complex problems requiring comprehensive cognitive analysis
|
|
161
|
+
- **Output:** Six-stage structured analysis with actionable recommendations
|
|
198
162
|
|
|
199
163
|
<div align="center">
|
|
200
|
-
|
|
164
|
+
╭────────────[ ◈◆◇ CITATION ◇◆◈ ]─────────────╮
|
|
201
165
|
</div>
|
|
202
166
|
|
|
203
|
-
## ᐴ
|
|
204
|
-
|
|
205
|
-
### Architecture
|
|
206
|
-
- **TypeScript**: Full type safety and modern ES modules
|
|
207
|
-
- **MCP Protocol**: Standard Model Context Protocol compliance
|
|
208
|
-
- **Zod Validation**: Runtime type checking and parameter validation
|
|
209
|
-
- **Progressive Context**: Accumulative cognitive enhancement
|
|
210
|
-
|
|
211
|
-
### Cognitive Frameworks Applied
|
|
212
|
-
- **Chain-of-Thought (CoT)**: Systematic reasoning chains
|
|
213
|
-
- **Tree-of-Thoughts (ToT)**: Parallel exploration paths
|
|
214
|
-
- **Self-Consistency**: Multi-path validation
|
|
215
|
-
- **Meta-Prompting**: Self-reflective quality control
|
|
216
|
-
- **Role-Based Prompting**: Expert perspective integration
|
|
217
|
-
|
|
218
|
-
### File Structure
|
|
219
|
-
```
|
|
220
|
-
├── src/index.ts # Main MCP server implementation
|
|
221
|
-
├── build/index.js # Compiled executable
|
|
222
|
-
├── latest.md # OOReDAct integration prompt (Licensed)
|
|
223
|
-
├── MANDATORY_STAGES.md # Stage progression documentation
|
|
224
|
-
└── package*.json # Dual package configuration
|
|
225
|
-
```
|
|
226
|
-
|
|
227
|
-
<div align="center">
|
|
228
|
-
◈──◆──◇───────────────────────────◇──◆──◈
|
|
229
|
-
</div>
|
|
167
|
+
## ᐴ MIŻIWEWIN ᔔ [CITATION/SHARING] ◈──◆──◇──◆──◈
|
|
230
168
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
|
|
234
|
-
|
|
235
|
-
### Development Setup
|
|
236
|
-
```bash
|
|
237
|
-
git clone https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp
|
|
238
|
-
cd gikendaasowin-aabajichiganan-mcp
|
|
239
|
-
pnpm install
|
|
240
|
-
pnpm build
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
<div align="center">
|
|
244
|
-
◈──◆──◇───────────────────────────◇──◆──◈
|
|
245
|
-
</div>
|
|
246
|
-
|
|
247
|
-
## ᐴ DIBENDAAGOZIIWIN ᔔ [LICENSE] ◈──◆──◇──◆──◈
|
|
248
|
-
|
|
249
|
-
This project is licensed under the Comprehensive Restricted Use License for Indigenous Creations with Tribal Sovereignty, Data Sovereignty, and Wealth Reclamation Protections - see the [LICENSE](LICENSE) file for details.
|
|
250
|
-
|
|
251
|
-
### Scholarly Citation
|
|
169
|
+
Please cite this project using the following BibTeX entry:
|
|
252
170
|
|
|
253
171
|
```bibtex
|
|
254
172
|
@misc{gikendaasowin-aabajichiganan-mcp2025,
|
|
255
173
|
author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
|
|
256
|
-
title/description = {
|
|
174
|
+
title/description = {Gikendaasowin Aabajichiganan MCP Server - Revolutionary 2-Round Cognitive Deliberation with Dynamic Prompting Strategy Evaluation},
|
|
257
175
|
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
|
|
258
176
|
year = {2025},
|
|
259
177
|
publisher/source/event = {GitHub repository under tribal sovereignty protections},
|
|
@@ -262,6 +180,14 @@ This project is licensed under the Comprehensive Restricted Use License for Indi
|
|
|
262
180
|
}
|
|
263
181
|
```
|
|
264
182
|
|
|
265
|
-
|
|
183
|
+
<div align="center">
|
|
184
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
185
|
+
</div>
|
|
186
|
+
|
|
187
|
+
This project is licensed under the [COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS](LICENSE).
|
|
188
|
+
|
|
189
|
+
<div align="center">
|
|
190
|
+
◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
|
|
191
|
+
</div>
|
|
266
192
|
|
|
267
193
|
Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.
|