Maiife Toolkit

오픈소스 AI 거버넌스 도구입니다. 각 도구는 MCP 서버 또는 CLI로 독립적으로 작동하며, 함께 사용하면 거버넌스 메시를 형성합니다.

npm scope License: Apache 2.0 PRs Welcome maiife-toolkit MCP server

maiife-toolkit MCP server

Maiife — 엔터프라이즈 AI 제어 평면에서 제작했습니다.

요구 사항

Node.js >= 18
npm 또는 pnpm

설치

# Install individual tools via npm
npm install -g @maiife-ai-pub/probe
npm install -g @maiife-ai-pub/mcp-audit

# Or run directly with npx (no install needed)
npx @maiife-ai-pub/probe scan
npx @maiife-ai-pub/mcp-audit scan

도구

패키지	설명	게시됨
`@maiife-ai-pub/shared`	모든 툴킷 패키지에서 사용하는 공유 타입 및 포맷터	✅
`@maiife-ai-pub/probe`	AI 환경 스캐너 — IDE 확장 프로그램, MCP 서버, 에이전트 프레임워크, API 키, 로컬 모델 검색	✅
`@maiife-ai-pub/mcp-audit`	MCP 서버 보안 스캐너 — 권한, 데이터 민감도, 영향 범위에 대한 설정 점수 산정	✅
`@maiife-ai-pub/ai-stack`	"당신의 AI 스택은 무엇인가요?" — AI 툴킷의 공유 가능한 프로필 카드	✅
`@maiife-ai-pub/mcp-doctor`	MCP 상태 점검 및 자동 수정 — MCP 설정을 위한 brew doctor	✅
`@maiife-ai-pub/ai-journal`	개인 AI 사용 일지 — AI 사용 방식을 추적하고 성찰적인 통찰력 제공	✅
`@maiife-ai-pub/context-sync`	도구 간 AI 메모리 동기화 — Cursor, Claude, MCP에 동기화되는 하나의 context.json	✅
`@maiife-ai-pub/prompt-score`	프롬프트 품질 분석기 — AI 프롬프트 점수 산정, 개선 및 린트	✅
`@maiife-ai-pub/eval`	LLM-as-judge 평가 엔진 — 구조화된 루브릭으로 에이전트 출력 점수 산정	✅
`@maiife-ai-pub/trace`	에이전트 워크플로우 추적기 — 실행 스팬 추적, 보기 및 분석	✅
`@maiife-ai-pub/cost`	AI 비용 계산기 + 최적화 도구 — 공급업체 전반의 통합 비용 보고서	✅
`@maiife-ai-pub/prompt-craft`	게임화된 프롬프트 코치 — 프롬프트 개선을 위한 레벨, 연속 기록, 배지	✅
`@maiife-ai-pub/sub-audit`	개인 AI 구독 감사 도구 — AI 지출의 낭비 요소 발견	✅
`@maiife-ai-pub/model-match`	개인 모델 추천 도구 — 귀하의 작업에 가장 적합한 모델 찾기	✅
`@maiife-ai-pub/weekly-ai-report`	AI 주간 리뷰 — 매주 제공되는 AI 사용량에 대한 Spotify Wrapped 스타일 보고서	✅

빠른 시작

# Scan your AI environment
npx @maiife-ai-pub/probe scan

# Audit your MCP server security
npx @maiife-ai-pub/mcp-audit scan

# Generate your AI Stack profile card
npx @maiife-ai-pub/ai-stack --format svg --output my-stack.svg

# Health check your MCP servers
npx @maiife-ai-pub/mcp-doctor check

# Log an AI interaction
npx @maiife-ai-pub/ai-journal log --tool claude --task coding --duration 30

# Sync AI context across tools
npx @maiife-ai-pub/context-sync push

# Score your AI prompts
npx @maiife-ai-pub/prompt-score analyze --input prompt.txt

# Evaluate agent outputs with rubrics
npx @maiife-ai-pub/eval score --rubric code-review --input review.txt

# Trace agent workflows
npx @maiife-ai-pub/trace list --days 7

# Track AI spend across vendors
npx @maiife-ai-pub/cost report --period last-30d

# Gamified prompt coaching
npx @maiife-ai-pub/prompt-craft score --input prompt.txt

# Audit AI subscriptions for waste
npx @maiife-ai-pub/sub-audit

# Find the best model for your tasks
npx @maiife-ai-pub/model-match recommend --task coding

# Generate your AI week in review
npx @maiife-ai-pub/weekly-ai-report generate

MCP 서버로 사용

각 도구는 Model Context Protocol을 통해 MCP 서버를 노출합니다. Claude Desktop, Cursor 또는 MCP 호환 클라이언트에 추가하세요.

설정 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maiife-probe": {
      "command": "npx",
      "args": ["@maiife-ai-pub/probe", "mcp"]
    },
    "maiife-mcp-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-audit", "serve"]
    },
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "serve"]
    },
    "maiife-ai-stack": {
      "command": "npx",
      "args": ["@maiife-ai-pub/ai-stack", "serve"]
    },
    "maiife-prompt-score": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-score", "serve"]
    },
    "maiife-eval": {
      "command": "npx",
      "args": ["@maiife-ai-pub/eval", "serve"]
    },
    "maiife-trace": {
      "command": "npx",
      "args": ["@maiife-ai-pub/trace", "serve"]
    },
    "maiife-cost": {
      "command": "npx",
      "args": ["@maiife-ai-pub/cost", "serve"]
    },
    "maiife-context-sync": {
      "command": "npx",
      "args": ["@maiife-ai-pub/context-sync", "serve"]
    },
    "maiife-prompt-craft": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-craft", "serve"]
    },
    "maiife-sub-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/sub-audit", "serve"]
    },
    "maiife-model-match": {
      "command": "npx",
      "args": ["@maiife-ai-pub/model-match", "serve"]
    }
  }
}

MCP 도구 요약

서버	도구	설명
`probe`	`probe_scan`, `probe_list_models`, `probe_list_extensions`, `probe_check_keys`	AI 환경 스캔
`mcp-audit`	`scan_servers`, `score_server`	MCP 보안 감사
`mcp-doctor`	`mcp_checkup`, `mcp_fix`, `mcp_status`	MCP 설정 진단 및 수정
`ai-stack`	`ai_stack_scan`	AI 스택 프로필 생성
`prompt-score`	`prompt_analyze`, `prompt_improve`, `prompt_track`	프롬프트 점수 산정 및 개선
`eval`	`eval_score`, `eval_batch`, `eval_compare`	LLM 출력 평가
`trace`	`trace_list`, `trace_view`, `trace_analyze`	에이전트 워크플로우 추적
`cost`	`cost_report`, `cost_optimize`	AI 지출 추적 및 최적화
`context-sync`	`context_get`, `context_set`, `context_push`, `context_pull`	AI 컨텍스트 동기화
`prompt-craft`	`craft_score`, `craft_improve`, `craft_profile`, `craft_challenge`	게임화된 프롬프트 코칭
`sub-audit`	`sub_audit_run`	AI 구독 감사
`model-match`	`model_compare`, `model_recommend`	모델 추천

기여하기

기여를 환영합니다! 시작하는 방법은 다음과 같습니다:

GitHub에서 저장소를 Fork 하세요.
브랜치 생성: git checkout -b feat/my-improvement
변경 사항 적용 — 각 패키지는 packages/<name>/에 위치합니다.
테스트 실행: pnpm test
main 브랜치로 PR을 오픈하세요 — 변경 내용과 이유를 설명해 주세요.

기존 코드 스타일(TypeScript, ESM, 테스트용 Vitest)을 따라주세요. 각 패키지는 가능한 경우 CLI와 MCP 서버로 모두 작동해야 합니다.

라이선스

Apache 2.0 — 자유롭게 사용, 수정 및 배포할 수 있습니다.

Maiife 플랫폼의 일부 — 엔터프라이즈 AI 제어 평면.

maiife-toolkit