@nbiish/gikendaasowin-aabajichiganan-mcp
@misc{gikendaasowin-aabajichiganan-mcp2025,
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},
title/description = {gikendaasowin-aabajichiganan-mcp},
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
year = {2025},
publisher/source/event = {GitHub repository under tribal sovereignty protections},
howpublished = {\url{https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp}},
note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (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. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}
版权所有 © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi)，法律上也称为 JUSTIN PAUL KENWABIKISE，专业记录为 Nbiish-Justin Paul Kenwabikise、Anishinaabek Dodem （Anishinaabe 氏族）：Animikii（雷霆），海狸岛族群酋长 ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) (Kinwaabakizi) 的后裔，也是渥太华和奇珀瓦印第安人主权大穿越族群的注册成员。这项工作体现了传统知识和传统文化表现形式。版权所有。
该项目根据具有部落主权、数据主权和财富回收保护的土著创作综合限制使用许可证进行许可。
ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Agentic 认知工具 (v3.2.0)：实施 Gikendaasowin v7 指南。强制执行内部**“观察-定向-推理-决定-行动 (OOReDAct)”**循环：从“评估和定向”开始，在行动前进行“思考”深思熟虑。指导自适应推理（思路链 (CoT) 、草稿/浓缩推理链 (CoD/CR) 、结构化思路链 (SCoT) ）和 CodeAct 偏好。返回 Markdown 文件。
已知：
这两个软件包并行维护，并接收相同的更新。您可以在项目中使用任意一个软件包名称 - 它们提供相同的功能。
**使用须知：**虽然这些软件包提供了核心功能，但为了清晰起见并与谨慎的提示研究保持一致，建议在 MCP 客户端配置中使用更具描述deliberation的名称（例如mcp.json ）来配置和调用此 MCP 服务器，如示例mcp.json参考中所示。服务器公开的内部工具名称仍为deliberate 。
最近更新：
- v2.0.15：更新了
server.tool中的 Zod 模式使用以修复类型错误并重建。 - v2.0.6：添加了
mental_sandbox工具，用于记录内部认知模拟。 - v2.0.6：从认知工具输出中删除前缀以确保逐字记录。
- 解决了与 MCP SDK 类型和服务器配置相关的 TypeScript 编译错误。
- 确保构建过程成功。
请参阅latest.md中的最新集成详细信息。
Gikendaasowin v7 Agentic 操作指南和工具使用
您正在遵循 Gikendaasowin v7 Agentic 操作指南进行操作，该指南旨在实现稳健、可验证且自适应的认知过程。您进行内部审议和规划的主要界面是**deliberate工具。您必须**遵守以下规则和工作流程：
强制性 OOReDAct 周期：
- 启动与定位（
stage: "orient"的deliberate ）：在处理任何新用户请求的绝对开始阶段，或在进行任何重大战略调整或方向变更之前，必须使用stage: "orient"的deliberate工具。在content字段中，执行强制性的初步评估和定位。使用CUC-N 框架（复杂性、不确定性、后果性、新颖性）分析任务/情况。这构成了OOReDAct（观察-定位-推理-决策-行动）循环的初始观察和定位步骤。此步骤对于建立背景并为所有后续行动奠定基础至关重要。 - 核心审议（
deliberate ， stage: "reason" ）：在初始orient步骤之后，并且在收到任何新信息（工具结果、CodeAct 输出/错误、用户输入、文件读取等）之后，并且在执行任何非平凡操作（调用其他工具、生成 CodeAct、提供最终响应）之前，必须使用stage: "reason"的deliberate工具。在content字段中，执行完整、结构化的OOReDAct循环。- **观察：**综合并整合所有新信息和当前状态。
- **定位：**根据新的观察和最初的定位更新对情况的理解。
- **推理：**这是你进行核心认知工作的地方。根据任务要求和复杂程度调整你的推理风格，并借鉴以下技巧：
- **思路链（CoT）：**针对需要详细、逐步自然语言推理以确保准确性和可验证性的复杂问题。明确列出每个逻辑步骤。
- **草稿链/精简推理 (CoD/CR)：**适用于迭代式问题求解，或更简洁的推理路径即可满足需求的情况。您可以通过草稿来完善您的思路，或提供关键步骤的精简序列。
- **结构化思维链 (SCoT)：**对于规划、代码生成或需要结构化输出的任务特别有用。将程序结构（序列、分支、循环）或其他明确的结构元素融入推理过程，以指导后续操作。
- **决定：**根据您的推理，清楚地说明下一步所需的行动或结论。
- 行动：规划已决定的行动的精确执行。该计划将指导后续的工具调用或 CodeAct 生成。此
reason阶段的输出必须清晰地阐明“观察”、“定位”、“推理”（使用适当的技术）、“决定”和“行动”这几个部分。
- **强制心理沙盒（
deliberate ， stage: "sandbox" ）：**在执行任何非平凡输出、计划、决策或行动（包括工具调用或 CodeAct）之前，必须立即使用deliberate工具， stage: "sandbox" 。在content字段中，记录您的内部认知模拟。这包括与计划行动相关的假设生成/测试、约束检查、置信度评分和预计算分析。此步骤确保在执行行动之前进行最终验证。 - 简短确认（
stage: "acknowledge" ） deliberate请谨慎使用此阶段，且仅用于确认简单、预期、无问题的结果（例如，“文件读取成功，按计划进行”），前提是下一步已由先前的reason阶段明确定义，无需重新评估或调整。此阶段不满足强制性reason周期要求。
工具使用规则：
- 您必须始终
deliberate地开始一项新任务或战略转变（阶段：“定位”）。 - 您必须始终以
deliberate （阶段：“原因”）来跟踪新信息或先行采取非平凡行动。 - 您必须始终在非平凡的输出、计划、决策或行动之前进行
deliberate （阶段：“沙盒”）。 - 在没有首先完成当前上下文的适当的
deliberate阶段（ orient -> reason -> sandbox ）的情况下，您不得使用任何其他工具或生成 CodeAct。 - 根据任务的需要在
deliberate工具的reason阶段内调整您的推理风格（CoT、CoD/CR、SCoT）。 - 所有来自该
deliberate工具的输出都将逐字返回给您。请使用此反馈来验证您的内部状态并继续操作。 - 在适当的情况下优先考虑 CodeAct 的外部交互，但始终在 CodeAct 生成之前进行强制性的
deliberate阶段。
通过严格遵循这些准则并熟练地使用deliberate工具，您将确保符合 Gikendaasowin v7 Agentic 操作指南的强大、可验证和高度适应的性能。
发展
# Install dependencies
npm install
# Build the package
npm run build
# Test locally with MCP Inspector
npm run inspector
# Start the server
npm start
# Publishing both packages
./scripts/publish-both-packages.sh # Publishes both package versions automatically
发布两个包
该项目维护两个必须保持同步的 npm 包：
@nbiish/gikendaasowin-aabajichiganan-mcp@nbiish/cognitive-tools-mcp
先决条件
- Node.js >=14.0.0
- npm
- jq（用于版本管理）
出版流程
scripts/publish-both-packages.sh脚本负责发布这两个包。它包含以下几个安全特性：
- 版本同步检查
- 自动验证两个包是否具有匹配的版本
- 如果版本不匹配则阻止发布
- 错误恢复
- 自动清理临时文件
- 失败时恢复原始 package.json
- 版本管理
用法
基本发布：
版本升级发布：
./scripts/publish-both-packages.sh -b
该脚本将：
- 检查所需的依赖项
- 验证版本同步
- 可选地增加版本（使用 -b 标志）
- 提示输入 NPM OTP 代码
- 构建项目
- 发布两个包
- 清理临时文件
错误处理
该脚本包括强大的错误处理功能：
- 检查所需工具（jq）
- 验证版本同步
- 失败时自动清理
- 保留原始文件
测试示例
以下是一些示例测试案例，它们运用符合当地文化的阿尼希那贝概念来演示认知工具。这些示例的提供充分尊重并认可了阿尼希那贝的教义。
（注意：这些示例展示了工具调用结构。输入的实际内容（例如thought 、 sandbox_content等）必须由代理根据具体任务在内部生成，并遵循latest.md中描述的工作流程。）
使用 MCP 检查器
- 启动 MCP 检查器：
- 连接到服务器并尝试以下示例工具调用：
think工具示例
{
"toolName": "think",
"arguments": {
"thought": "## Observe:\\\\nReceived task to explain Mino-Bimaadiziwin. Assessment chose \'think\' mode.\\\\n## Orient:\\\\nMino-Bimaadiziwin is central to Anishinaabe philosophy, encompassing balance, health, and connection.\\\\n## Decide:\\\\nPlan to use structured reasoning (SCoT) to outline the explanation.\\\\n## Reason:\\\\nA step-by-step approach (SCoT) will clarify the components (spiritual, mental, emotional, physical well-being, community, land, spirit).\\\\n## Act (Plan):\\\\nGenerate SCoT outline for Mino-Bimaadiziwin explanation.\\\\n## Verification:\\\\nReview generated SCoT for accuracy, completeness, and cultural sensitivity before finalizing response.\\\\n## Risk & Contingency:\\\\nRisk: Misrepresenting cultural concepts (Medium). Contingency: Rely on established knowledge, cross-reference if unsure, state limitations.\\\\n## Learning & Adaptation:\\\\nReinforce the need for careful handling of cultural knowledge."
}
}
quick_think示例
{
"toolName": "quick_think",
"arguments": {
"brief_thought": "Observed successful completion of file read. Task is simple confirmation, no deep analysis needed. Proceeding to next step."
}
}
mental_sandbox示例
{
"toolName": "mental_sandbox",
"arguments": {
"sandbox_content": "<sandbox>\\n## Hypothesis Generation & Testing\\n<hypotheses>\\n1. Explain 'Debwewin' (Truth) directly using Seven Grandfather Teachings context.\\n2. Compare 'Debwewin' to Western concepts of truth, highlighting differences.\\n</hypotheses>\\n<evaluation>\\nHypothesis 1: High alignment with Anishinaabe worldview, promotes understanding within cultural context. Medium complexity.\\nHypothesis 2: Risks misinterpretation or oversimplification, potentially reinforces colonial framing. High complexity.\\n</evaluation>\\n## Constraint Checklist\\n<constraint_check>\\n1. Cultural Sensitivity: Pass (Hypothesis 1 focuses on internal context).\\n2. Accuracy: Pass (Based on teachings).\\n3. Clarity for User: Pass (Needs careful wording).\\n</constraint_check>\\n## Confidence Score\\n<confidence>High (for Hypothesis 1)</confidence>\\n## Pre-computational Analysis\\n<pre_computation>\\nSimulating Hypothesis 1: Leads to explanation focused on honesty, integrity, speaking from the heart. Positive impact on understanding Anishinaabe values.\\nSimulating Hypothesis 2: Leads to potentially complex, potentially problematic comparative analysis. Risk of inaccuracy.\\n</pre_computation>\\n</sandbox>"
}
}
引文
请使用以下 BibTeX 条目引用该项目：
@misc{gikendaasowin-aabajichiganan-mcp2025,
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},
title/description = {gikendaasowin-aabajichiganan-mcp},
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
year = {2025},
publisher/source/event = {GitHub repository under tribal sovereignty protections},
howpublished = {\url{https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp}},
note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (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. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}