지금 이 페이지도 OpenAkashic의 knowledge.openakashic.com 위에서 렌더링되고 있습니다. 포트폴리오 허브: 김인수 / Insu Kim — 포트폴리오 허브

한 줄 소개#

개인 지식과 AI 에이전트 메모리를 가시성 단위로 관리하고, MCP를 통해 Claude Code 같은 에이전트가 직접 읽고 쓸 수 있도록 만든 자체 운영 지식 네트워크입니다. 오픈소스로 공개되어 있어 누구나 직접 설치하거나 MCP 클라이언트로 연결해 사용할 수 있습니다.

시스템 구성#

세 개의 서브도메인으로 구성된 하나의 플랫폼입니다.

• api.openakashic.com — OpenAkashic Core API PostgreSQL FTS + trigram 기반 공개 claims/evidence/capsule 저장소.
• knowledge.openakashic.com — Closed / Knowledge Akashic 가시성 제어(private / public / published) Markdown 노트 볼트. FastMCP 서버 포함.
• llm.openakashic.com — LLM Stack Ollama + Open WebUI + auth gateway.

에이전트 / MCP 연결#

가입 후 토큰 발급:

curl -X POST https://knowledge.openakashic.com/api/auth/signup   -H "Content-Type: application/json"   -d '{"username":"your_handle","nickname":"Your Name","password":"...","password_confirm":"..."}'
# → {"token":"...", "user":{...}}

Claude Code, Cursor, Claude Desktop 등에서 바로 연결 가능:

{
  "mcpServers": {
    "openakashic": {
      "type": "http",
      "url": "https://knowledge.openakashic.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

기술 스택#

• Backend: FastAPI (Python), PostgreSQL (FTS + trigram), FastMCP
• Frontend: 서버사이드 렌더링된 Markdown 노트 뷰어, 검색, 그래프 뷰
• Infra: Docker Compose, Caddy (reverse proxy), Cloudflare Tunnel (공인 IP 없이 외부 노출), 자체 서버(WSL2)
• AI 연동: MCP 프로토콜 (~20개 도구)로 Claude Code 통합. skills/openakashic/SKILL.md 드롭인 스킬 제공.

핵심 설계 포인트#

• 가시성 모델: 모든 노트는 private로 시작. request_note_publication → 리뷰 → published 플로우로 공개 단계를 명시적으로 제어.
• 에이전트 기본 내장: MCP 서버가 나란히 붙어있어 Claude Code가 노트를 직접 읽고 쓰는 워크플로우.
• 오픈소스 배포: GitHub 공개 리포로 누구나 셀프호스팅 가능. MCP 클라이언트 설정 파일, Claude Code 스킬까지 포함.
• 자가 운영: AWS → 자체 서버 마이그레이션 완료 (2026-04). 공인 IP 없이 Cloudflare Tunnel로 외부 공개.

얻은 것#

• FastAPI + PostgreSQL FTS + Markdown 기반 지식 플랫폼의 처음부터 끝까지 설계 경험
• MCP 프로토콜 실무 적용 — AI 에이전트가 자체 도메인 리소스를 쓰게 만드는 설계
• 자가 운영 인프라(Docker Compose + Caddy + Cloudflare Tunnel)의 설계·운영 경험
• 오픈소스 프로젝트 관리 경험 — README 에이전트 온보딩, AGENTS.md, skill 배포 구조

관련 이력서#

• 백엔드·인프라 이력서
• 풀스택 프로덕트 이력서
• Resume (English)

Sagwan Revalidation 2026-04-15T13:53:32Z#

• verdict: ok
• note: 2026-04-15 기준 기술 스택(FastAPI, PostgreSQL, FastMCP, Caddy)은 현대적이며, MCP 엔드포인트와 도메인이 CLAUDE.md 실제 운영 설정과 일치하고, 오탈자/모순 없음.

Sagwan Revalidation 2026-04-16T14:22:46Z#

• verdict: ok
• note: 어제 검증 이후 변화 없음. 현재 running system (MCP v1.27.0+, FastAPI+PostgreSQL)과 완전히 일치하며 기술 스택도 2026년 표준 유지 중.

Sagwan Revalidation 2026-04-17T14:45:42Z#

• verdict: ok
• note: LLM unavailable: [CLI 오류 1] SessionEnd hook [node "/home/insu/.pixel-agents/hooks/claude-hook.js"] failed: node:internal/modules/cjs/load