@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.}
}
Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), también conocido legalmente como JUSTIN PAUL KENWABIKISE, documentado profesionalmente como Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendiente del Jefe ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) de Beaver Island Band, y miembro inscrito de la soberana Grand Traverse Band de los indios Ottawa y Chippewa. Esta obra incorpora los conocimientos tradicionales y las expresiones culturales tradicionales. Reservados todos los derechos.
Este proyecto está licenciado bajo la LICENCIA DE USO RESTRINGIDO INTEGRAL PARA CREACIONES INDÍGENAS CON SOBERANÍA TRIBAL, SOBERANÍA DE DATOS Y PROTECCIONES DE RECUPERACIÓN DE RIQUEZA .
Herramientas cognitivas agenéticas (v3.2.0): Implementa las directrices de Gikendaasowin v7. Aplica el ciclo interno OBLIGATORIO Observar-Orientar-Razonar-Decidir-Actuar (OOReDAct) : Comienza con 'evaluar_y_orientar' y continúa con la deliberación 'pensar' antes de actuar. Guía el razonamiento adaptativo ( Cadena de Pensamiento (CoT) , Cadena de Borrador/Razonamiento Condensado (CoD/CR) , Cadena de Pensamiento Estructurada (SCoT) ) y la preferencia de CodeAct. Devuelve Markdown.
Conocido como:
Ambos paquetes se mantienen en paralelo y reciben las mismas actualizaciones. Puedes usar cualquiera de los dos nombres de paquete en tus proyectos; ofrecen la misma funcionalidad.
Nota sobre el uso: Si bien los paquetes proporcionan la funcionalidad principal, para mayor claridad y coherencia con una investigación exhaustiva, se recomienda configurar e invocar este servidor MCP con un nombre más descriptivo, como deliberation , en la configuración del cliente MCP (p. ej., mcp.json ), como se muestra en la referencia de ejemplo mcp.json . El nombre de la herramienta interna expuesta por el servidor sigue siendo deliberate .
Actualizaciones recientes:
- v2.0.15: Se actualizó el uso del esquema Zod en
server.tool para corregir el error de tipo y se reconstruyó. - v2.0.6: Se agregó la herramienta
mental_sandbox para registrar simulaciones cognitivas internas. - v2.0.6: Se eliminaron los prefijos de las salidas de la herramienta cognitiva para garantizar un registro textual.
- Se resolvieron errores de compilación de TypeScript relacionados con los tipos de SDK de MCP y la configuración del servidor.
- Se aseguró un proceso de construcción exitoso.
Consulte los últimos detalles de integración en latest.md .
Directrices operativas y uso de herramientas de Gikendaasowin v7 Agentic
Opera bajo las Directrices Operativas de Gikendaasowin v7, diseñadas para procesos cognitivos robustos, verificables y adaptativos. Su interfaz principal para la deliberación y planificación internas es la herramienta deliberate . Debe adherirse a las siguientes reglas y flujo de trabajo:
Ciclo OOReDAct OBLIGATORIO:
- Iniciación y Orientación (
deliberate con stage: "orient" ): Al inicio del procesamiento de cualquier nueva solicitud de usuario o antes de cualquier cambio estratégico o de dirección significativo, DEBE utilizar la herramienta deliberate con stage: "orient" . En el campo content , realice una evaluación y orientación inicial obligatorias. Analice la tarea/situación utilizando el marco CUC-N (Complejidad, Incertidumbre, Consecuencia, Novedad) . Esto constituye los pasos iniciales de Observar y Orientar del ciclo OOReDAct (Observar-Orientar-Razonar-Decidir-Actuar) . Este paso es fundamental para establecer el contexto y fundamentar todas las acciones posteriores. - Deliberación básica (
deliberate con stage: "reason" ): Tras el paso inicial orient , y de forma crucial después de recibir cualquier información nueva (resultados de herramientas, resultados/errores de CodeAct, entrada del usuario, lecturas de archivos, etc.), y ANTES de ejecutar cualquier acción importante (llamar a otras herramientas, generar CodeAct, proporcionar una respuesta final), DEBE usar la herramienta deliberate con stage: "reason" . En el campo content , realice un ciclo OOReDAct completo y estructurado.- Observar: Sintetizar e integrar toda la información nueva y el estado actual.
- Orientar: Actualizar tu comprensión de la situación en base a las nuevas observaciones y la orientación inicial.
- Razón: Aquí es donde se realiza el trabajo cognitivo fundamental. Adapte su estilo de razonamiento según los requisitos y la complejidad de la tarea, utilizando las siguientes técnicas:
- Cadena de Pensamiento (CdP): Para problemas complejos que requieren un razonamiento detallado, paso a paso, en lenguaje natural para garantizar la precisión y la verificabilidad. Explique cada paso lógico.
- Razonamiento en Cadena de Borradores/Condensado (CdD/RC): Para la resolución iterativa de problemas o cuando un razonamiento más conciso es suficiente. Refine su razonamiento mediante borradores o proporcione una secuencia condensada de pasos clave.
- Cadena de Pensamiento Estructurada (SCoT): Especialmente útil para la planificación, la generación de código o tareas que requieren resultados estructurados. Incorpore estructuras de programa (secuencia, rama, bucle) u otros elementos estructurales explícitos en su proceso de razonamiento para guiar la acción posterior.
- Decidir: Basándose en su razonamiento, indique claramente las siguientes acciones o conclusiones requeridas.
- Actuar: Planificar la ejecución precisa de las acciones decididas. Este plan guiará las llamadas a herramientas posteriores o la generación de CodeAct. El resultado de esta etapa
reasonDEBE articular claramente los componentes Observar, Orientar, Razonar (utilizando una técnica adecuada), Decidir y Actuar.
- Zona de pruebas mental obligatoria (
deliberate con stage: "sandbox" ): INMEDIATAMENTE ANTES de ejecutar cualquier resultado, plan, decisión o acción importante (incluidas las llamadas a herramientas o CodeAct), DEBE usar la herramienta deliberate con stage: "sandbox" . En el campo content , registre su simulación cognitiva interna. Esto incluye la generación/prueba de hipótesis, las comprobaciones de restricciones, la puntuación de confianza y el análisis precomputacional relacionados con la acción planificada. Este paso garantiza una verificación final antes de comprometerse con una acción. - Reconocimiento breve (
deliberate con stage: "acknowledge" ): Utilice esta etapa con moderación y únicamente para reconocer resultados simples, esperados y no problemáticos (p. ej., "Archivo leído correctamente, procediendo según lo planeado"), donde el siguiente paso ya está claramente definido por una etapa reason previa y no requiere reevaluación ni adaptación. Esta etapa no cumple con el requisito obligatorio del ciclo de reason .
Reglas de uso de herramientas:
- Siempre debes comenzar una nueva tarea o un cambio estratégico con
deliberate (etapa: "orientar"). - Siempre debes seguir la nueva información o preceder acciones no triviales con
deliberate (etapa: "razón"). - Siempre debes preceder a los resultados, planes, decisiones o acciones no triviales con
deliberate (etapa: "sandbox"). - NO DEBE utilizar ninguna otra herramienta ni generar CodeAct sin completar primero las etapas
deliberate apropiadas ( orient -> reason -> sandbox ) para el contexto actual. - Adapte su estilo de razonamiento (CoT, CoD/CR, SCoT) dentro de la etapa
reason de la herramienta deliberate en función de las necesidades de la tarea. - Recibirá todos los resultados de la herramienta
deliberate textualmente. Utilice esta información para verificar su estado interno y continuar. - Priorice CodeAct para interacciones externas cuando sea apropiado, pero SIEMPRE preceda la generación de CodeAct con las etapas
deliberate obligatorias.
Si sigue estrictamente estas pautas y utiliza de forma experta la herramienta deliberate , garantizará un rendimiento sólido, verificable y altamente adaptable, alineado con las Pautas operativas de Agentic de Gikendaasowin v7.
Desarrollo
# 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
Publicando ambos paquetes
Este proyecto mantiene dos paquetes npm que deben mantenerse sincronizados:
@nbiish/gikendaasowin-aabajichiganan-mcp@nbiish/cognitive-tools-mcp
Prerrequisitos
- Node.js >=14.0.0
- npm
- jq (para gestión de versiones)
Proceso de publicación
El script scripts/publish-both-packages.sh gestiona la publicación de ambos paquetes. Incluye varias funciones de seguridad:
- Comprobación de sincronización de versiones
- Verifica automáticamente que ambos paquetes tengan versiones coincidentes
- Evita la publicación si las versiones no coinciden
- Recuperación de errores
- Limpieza automática de archivos temporales
- Restaura el paquete .json original en caso de error
- Gestión de versiones
- Versión automática opcional bumping
- Asegura que ambos paquetes mantengan la misma versión
Uso
Publicación básica:
Publicación con aumento de versión:
./scripts/publish-both-packages.sh -b
El guión hará lo siguiente:
- Comprobar las dependencias requeridas
- Verificar la sincronización de versiones
- Versiones opcionales (con el indicador -b)
- Solicitud de código OTP de NPM
- Construir el proyecto
- Publicar ambos paquetes
- Limpiar archivos temporales
Manejo de errores
El script incluye un manejo robusto de errores:
- Comprueba las herramientas necesarias (jq)
- Valida la sincronización de versiones
- Limpieza automática en caso de fallo
- Conserva los archivos originales
Ejemplos de pruebas
A continuación, se presentan algunos ejemplos de casos de prueba que demuestran las herramientas cognitivas utilizando conceptos anishinaabe culturalmente apropiados. Estos ejemplos se ofrecen con respeto y reconocimiento de las enseñanzas anishinaabe.
(Nota: Estos ejemplos muestran la estructura de invocación de herramientas. El contenido real para entradas como thought , sandbox_content , etc., debe ser generado internamente por el agente en función de la tarea específica, siguiendo los flujos de trabajo descritos en latest.md ).
Uso del inspector MCP
- Inicie el Inspector MCP:
- Conéctese al servidor y pruebe estas llamadas de herramientas de ejemplo:
Ejemplo de herramienta 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."
}
}
Ejemplo 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."
}
}
Ejemplo 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>"
}
}
Citación
Por favor, cite este proyecto utilizando la siguiente entrada 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.}
}