CLU Avatar MCP Server

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

📋 기능

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

🚀 설치

$3

``bash
npm install -g clu-mcp-server
`

⚙️ 설정

$3

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

$3

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

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

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

`bash


node 경로 확인

which node

예: /opt/homebrew/opt/node@22/bin/node

글로벌 모듈 경로 확인

npm root -g

예: /opt/homebrew/lib/node_modules

`

#### 설정 예시

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

`json
{
"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의 MCP 설정에 추가 (Settings → MCP → Add Server):

`json
{
"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에서 자연어로 요청하면 됩니다:

$3

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

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

$3

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

$3

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

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

📊 환경 변수

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

🔧 개발

$3

`bash
npm install
`

$3

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

$3

`bash
npm run build
`

🔐 보안

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

📈 토큰 사용량 추적

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

📝 라이선스

MIT License

🔗 관련 링크

- CLU 플랫폼
- MCP 프로토콜 문서
- Claude Desktop

💬 문의

- 이메일: support@aiclude.com
- 웹사이트: https://aiclude.com