@nbiish/gikendaasowin-aabajichiganan-mcp
지엑스피1
저작권 © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), 법적으로는 JUSTIN PAUL KENWABIKISE라고도 알려져 있으며 전문적으로는 Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem으로 기록되어 있습니다. (아니시나베 일족): 비버 아일랜드 밴드 추장 ᑭᓇᐙᐸᑭᓯ(Kinwaabakizi)의 후손이자 오타와 및 치페와 인디언의 주권 그랜드 트래버스 밴드에 등록된 멤버인 애니미키(천둥). 이 작품은 전통 지식과 전통 문화 표현을 구현합니다. 모든 권리 보유.
이 프로젝트는 부족 주권, 데이터 주권 및 부의 회수 보호를 갖춘 토착 창작물에 대한 포괄적 제한 사용 라이선스 에 따라 라이선스가 부여되었습니다.
ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Agentic Cognitive Tools(v3.2.0): Gikendaasowin v7 가이드라인을 구현합니다. 필수적인 내부 관찰-지향-이성-결정-행동(OOReDAct) 주기를 적용합니다. '평가-지향'으로 시작하여 행동 전 '생각' 숙고로 이어집니다. 적응적 추론( 사고 연쇄(CoT) , 초안/축약 추론(CoD/CR) , 구조적 사고 연쇄(SCoT) ) 및 CodeAct 선호도를 안내합니다. 마크다운을 반환합니다.
~로 알려짐:
두 패키지는 병렬로 관리되며 동일한 업데이트를 받습니다. 프로젝트에서 두 패키지 이름 중 하나를 사용할 수 있으며, 동일한 기능을 제공합니다.
사용 관련 참고 사항: 패키지는 핵심 기능을 제공하지만, 명확성과 신중한 조사를 통한 일관성을 위해 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 단계의 결과는 관찰(Observe), 방향 설정(Orient), 추론(Reason, 적절한 기법 사용), 결정(Decide), 실행(Act) 구성 요소를 명확하게 표현 해야 합니다 .
- 필수 멘탈 샌드박스(
stage: "sandbox" 를 사용하여 deliberate ): 중요한 출력, 계획, 결정 또는 작업(도구 호출 또는 CodeAct 포함)을 실행하기 직전에 반드시 stage: "sandbox" 사용하여 deliberate 으로 도구를 실행해야 합니다. 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
필수 조건
- 노드.js >=14.0.0
- 엔피엠
- 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.}
}