clu-mcp-server

v1.0.4

Published

2 months ago

MCP server for CLU Avatar - Text chat integration with Claude Desktop

0High
0Medium
0Low

aiclude

mcp model-context-protocol clu avatar ai chatbot claude

CLU Avatar MCP Server

CLU 아바타와 텍스트 채팅을 할 수 있는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Cursor 등 MCP를 지원하는 AI 클라이언트에서 사용할 수 있습니다.

📋 기능

chat: CLU 아바타와 대화
get_avatar_info: 연결된 아바타 정보 조회
get_usage_stats: 토큰 사용량 통계 조회

🚀 설치

npm으로 설치

npm install -g clu-mcp-server

⚙️ 설정

1. API 키 발급

CLU 플랫폼에 로그인
에이전트 상세 페이지 → 연결 탭
새 연결 버튼 클릭 → MCP 서버 선택
생성된 API 키 복사

2. Claude Desktop 설정

Claude Desktop의 설정 파일을 수정합니다:

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

경로 확인 (터미널에서 실행)

# node 경로 확인
which node
# 예: /opt/homebrew/opt/node@22/bin/node

# 글로벌 모듈 경로 확인
npm root -g
# 예: /opt/homebrew/lib/node_modules

설정 예시

위에서 확인한 경로를 사용하여 설정합니다:

{
  "mcpServers": {
    "clu-avatar": {
      "command": "/opt/homebrew/opt/node@22/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/clu-mcp-server/dist/index.js"],
      "env": {
        "CLU_API_KEY": "your-api-key-here",
        "CLU_API_URL": "https://clu.aiclude.com"
      }
    }
  }
}

⚠️ 중요: command와 args 경로를 본인 환경에 맞게 수정하세요.

command: which node 결과 경로
args: npm root -g 결과 + /clu-mcp-server/dist/index.js

3. Cursor 설정

Cursor의 MCP 설정에 추가 (Settings → MCP → Add Server):

{
  "mcpServers": {
    "clu-avatar": {
      "command": "/opt/homebrew/opt/node@22/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/clu-mcp-server/dist/index.js"],
      "env": {
        "CLU_API_KEY": "your-api-key-here",
        "CLU_API_URL": "https://clu.aiclude.com"
      }
    }
  }
}

⚠️ 경로는 본인 환경에 맞게 수정하세요 (위 "경로 확인" 참고).

🎯 사용 방법

Claude Desktop 또는 Cursor에서 자연어로 요청하면 됩니다:

채팅

CLU 아바타에게 "안녕하세요, 오늘 날씨가 어떤가요?"라고 물어봐줘

chat 도구로 "회사 소개 부탁드립니다"라고 전송해줘

아바타 정보 확인

연결된 CLU 아바타 정보 알려줘

토큰 사용량 확인

이번 달 토큰 사용량 조회해줘

최근 7일간 API 사용 통계 보여줘

📊 환경 변수

| 변수명 | 필수 | 설명 | 기본값 | |--------|------|------|--------| | CLU_API_KEY | ✅ | CLU API 키 | - | | CLU_API_URL | ❌ | API 베이스 URL | https://clu.aiclude.com |

🔧 개발

의존성 설치

npm install

개발 모드 실행

export CLU_API_KEY="a_your-api-key-here"
npm run dev

빌드

npm run build

🔐 보안

API 키는 환경변수로 관리하세요. 코드에 직접 입력하지 마세요.
API 키가 유출된 경우 즉시 비활성화하고 새로운 키를 발급받으세요.
토큰 사용량은 API 키별로 자동 추적되므로 과금 관리가 가능합니다.

📈 토큰 사용량 추적

모든 채팅 요청은 API 키별로 토큰 사용량이 자동 기록됩니다.
get_usage_stats 도구로 사용량을 확인할 수 있습니다.
CLU 플랫폼의 연결 탭에서도 사용량을 확인할 수 있습니다.