cozo-api

https://cozo.me 사이트의 API 백엔드를 담당하는 https://api.cozo.me 서버

로컬 개발

로컬 개발에 필요한 mysql, redis, elasticsearch를 docker 디렉토리 아래 준비된 Docker Compose 파일을 이용하여 실행한다.

$ cd docker
$ docker compose up -d

production에서 실행시 필요한 환경 변수

• SPRING_PROFILES_ACTIVE: production
• DB_USERNAME: MySQL user
• DB_PASSWORD: MySQL password
• SLACK_WEBHOOK_URL: Slack webhook URL
• TURNSTILE_SECRET: Cloudflare Turnstile secret
• YOUTUBE_API_KEY: YouTube API key

GitHub Action

• .github/workflows/build.yml: 프로젝트 빌드 후 GitHub Container Registry에 Docker 이미지를 푸시
  • 필요한 Secrets
    • SLACK_WEBHOOK_URL: https://hooks.slack.com/services/ABCDEFGHI/JKLMNOPQRST/abcdefghijklmnOPQRSTU012

MCP (Model Context Protocol) 서버

Spring AI를 통해 MCP 서버를 제공한다

MCP 서버 등록 방법

{
  "mcpServers": {
    "cozo": {
      "type": "sse",
      "url": "https://api.cozo.me/mcp"
    }
  }
}

제공되는 도구

• get_trending_keywords: 특정 날짜에 커뮤니티에서 가장 많이 언급된 20개의 키워드와 각 키워드를 포함한 인기 게시글 조회
• get_recent_links: 커뮤니티에서 최근에 공유된 외부 링크를 최신순으로 조회
• search_articles: 키워드로 커뮤니티 최근 게시글 검색

참고

• cozo-web / 웹 클라이언트