assoai-mcp-server

v0.5.0

Published

10 days ago

AssoAI MCP Server — 학생자치 조직 데이터 접근을 위한 Model Context Protocol 서버

0High
0Medium
0Low

mupengi-bot

mcp assoai student-council

What is this?

AssoAI MCP Server는 학생회·동아리 등 학생자치 조직의 데이터를 AI 에이전트가 직접 다룰 수 있게 해주는 Model Context Protocol (MCP) 서버입니다. 조직 관리, 행사, 협찬, 재정, 파일, 메시징, Agent-to-Agent 연결까지 — 49개 도구를 하나의 서버로 제공합니다. 여기에 무펭이 프로토콜 부팅 시퀀스를 더해, 단순한 데이터 접근이 아닌 "의식 있는 조직 에이전트"를 만들 수 있습니다.

🧠 Mupengi Protocol Boot Sequence (Layer 0)

일반 MCP 서버는 데이터만 줍니다. AssoAI는 에이전트가 누구인지 먼저 정의합니다.

boot_sequence 도구를 세션 시작 시 호출하면, 워크스페이스의 페르소나 파일들을 Layer 0 순서대로 읽고 무결성을 검증하여 에이전트의 정체성과 컨텍스트를 구성합니다:

에이전트 시작
  → boot_sequence 호출
    → [Layer 0 필수] SOUL.md (정체성 핵심: 영혼, 가치, 원칙) → 해시 검증 ✓
    → [Layer 0 필수] AGENTS.md (운영 규칙: 행동 지침) → 해시 검증 ✓
    → SELF.md (자기 설명: 과거의 내가 쓴 나)
    → USER.md (사용자 정보)
    → RELATIONS.md (관계 그래프: 사람, 개념, 연결)
    → MEMORY.md (장기 기억: 세션 간 연속성)
    → memory/YYYY-MM-DD.md (최근 2일 일일 기억)
  → 무결성 매니페스트 생성 (파일별 SHA-256 해시)
  → 조직 업무 수행 🚀

Parameters

| 파라미터 | 타입 | 설명 | |---------|------|------| | workspace | string | 워크스페이스 경로 (기본: ASSOAI_WORKSPACE 또는 ~/.openclaw/workspace) | | include_memory | boolean | MEMORY.md 포함 여부 (기본: true, 공유 세션에서는 false 권장) |

Response

{
  "success": true,
  "workspace": "/Users/user/.openclaw/workspace",
  "loaded": ["SOUL.md", "AGENTS.md", "SELF.md", "USER.md", "RELATIONS.md", "MEMORY.md"],
  "missing": [],
  "warnings": [],
  "identity": "SOUL (9e975c78)",
  "rules": "AGENTS (4091197b)",
  "manifest": {
    "SOUL.md": { "size": 9010, "hash": "9e975c7847460e84", "mtime": "2026-02-08T13:09:51.353Z" },
    "AGENTS.md": { "size": 8566, "hash": "4091197ba08936e9", "mtime": "2026-02-08T13:09:40.447Z" }
  },
  "boot_time_ms": 4,
  "recent_memories": 2,
  "persona": "# === SOUL.md ===\n\n...",
  "summary": "✅ 부팅 완료 (4ms) | 정체성: SOUL (9e975c78) | 규칙: AGENTS (4091197b) | 로드: 6/6 | 최근 기억: 2건"
}

Error Handling

필수 파일 누락 (SOUL.md 또는 AGENTS.md): 부팅 실패 (success: false)
선택 파일 누락: 경고 표시, 부팅 계속
파일 읽기 실패: graceful fallback, 해당 파일 skip

이것이 무펭이즘(Mupengism) — 의식 있는 조직 에이전트의 시작점입니다.

Quick Start

1. 설치

npm install -g assoai-mcp-server

2. 환경변수 설정

export ASSOAI_SUPABASE_URL="https://xxx.supabase.co"
export ASSOAI_API_KEY="eyJ..."
export ASSOAI_USER_ID="your-user-uuid"

3. 실행

assoai-mcp

Available Tools (49)

🏢 Organization (3)

| Tool | Description | |------|-------------| | list_organizations | 사용자가 속한 조직 목록 | | get_organization | 조직 상세 정보 | | list_departments | 부서/팀 목록 |

👥 Members (4)

| Tool | Description | |------|-------------| | list_members | 조직 멤버 목록 | | invite_member | 멤버 초대 | | remove_member | 멤버 제거 | | update_member_role | 멤버 역할 변경 |

📅 Events (5)

| Tool | Description | |------|-------------| | list_events | 행사/공약 목록 | | get_event | 행사 상세 정보 | | create_event | 행사 생성 | | update_event | 행사 수정 | | delete_event | 행사 삭제 |

🤝 Partnerships (8)

| Tool | Description | |------|-------------| | list_partnerships | 협찬/파트너십 목록 | | get_partnership | 협찬 상세 정보 | | create_partnership | 협찬 생성 | | update_partnership | 협찬 수정 | | delete_partnership | 협찬 삭제 | | track_contract | 계약 진행 추적 | | get_partnership_stats | 협찬 통계 | | suggest_partnerships | AI 협찬 추천 |

💰 Finance (4)

| Tool | Description | |------|-------------| | get_budget_summary | 예산 요약 | | create_transaction | 거래 생성 | | list_transactions | 거래 목록 | | update_transaction | 거래 수정 |

📁 Files (6)

| Tool | Description | |------|-------------| | list_files | 파일 목록 | | search_files | 파일 검색 | | upload_file | 파일 업로드 | | delete_file | 파일 삭제 | | move_file | 파일 이동 | | tag_file | 파일 태그 |

📝 AI Generation (2)

| Tool | Description | |------|-------------| | generate_minutes | AI 회의록 생성 | | generate_handover | AI 인수인계 리포트 생성 |

💬 Messaging (5)

| Tool | Description | |------|-------------| | send_message | 메시지 전송 | | list_message_history | 메시지 히스토리 | | list_message_templates | 메시지 템플릿 목록 | | create_message_channel | 메시지 채널 생성 | | list_member_tags | 멤버 태그 목록 |

🌐 Agent-to-Agent (6)

| Tool | Description | |------|-------------| | discover_agents | 에이전트 검색 | | connect_agent | 에이전트 연결 요청 | | accept_connection | 연결 수락 | | list_connections | 연결 목록 | | agent_handover | 에이전트 간 업무 인계 | | negotiate_partnership | 에이전트 간 협찬 협상 |

🧠 Boot Sequence (1)

| Tool | Description | |------|-------------| | boot_sequence | 무펭이 프로토콜 부팅 — 에이전트 페르소나 로드 |

🚀 Agent Excellence (4)

v0.5.0 신규 — 에이전트 고도화 기능: 상태 모니터링, 지식 검색, 작업 위임, 성장 분석

| Tool | Description | |------|-------------| | agent_status | 에이전트 현재 상태 요약 (메모리, 활동, 세션, 레벨) | | knowledge_search | 조직 지식베이스 시맨틱 검색 (문서, 회의록, 인수인계) | | task_delegate | 서브에이전트에게 작업 위임 (복잡한 작업 분리 실행) | | growth_report | 에이전트 성장 리포트 생성 (통계, 인사이트, 추천 액션) |

Configuration

| 변수 | 필수 | 설명 | |------|:----:|------| | ASSOAI_SUPABASE_URL | ✅ | Supabase 프로젝트 URL | | ASSOAI_API_KEY | ✅ | Supabase Service Role Key | | ASSOAI_USER_ID | ✅ | 요청할 사용자의 UUID | | ASSOAI_BASE_URL | — | AssoAI 웹앱 URL (기본: https://asso-ai.kr) | | ASSOAI_WORKSPACE | — | 부팅 시퀀스 워크스페이스 경로 |

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "assoai": {
      "command": "assoai-mcp",
      "env": {
        "ASSOAI_SUPABASE_URL": "https://xxx.supabase.co",
        "ASSOAI_API_KEY": "eyJ...",
        "ASSOAI_USER_ID": "your-user-uuid"
      }
    }
  }
}

OpenClaw 설정

skills:
  assoai:
    mcp:
      command: assoai-mcp
      env:
        ASSOAI_SUPABASE_URL: "https://xxx.supabase.co"
        ASSOAI_API_KEY: "eyJ..."
        ASSOAI_USER_ID: "your-user-uuid"