arkon은(는) 무엇을 하나요?
Arkon: 엔터프라이즈 AI 지식 허브 & MCP 서버
팀이 RAG 컨텍스트, 접근 정책 및 AI 스킬을 관리할 수 있는 자체 호스팅 지식 베이스입니다. Model Context Protocol (MCP)을 통해 Claude 및 기타 LLM을 연결하여 자동화되고 안전한 조직 지식 통합을 실현합니다.
개요
Arkon은 기업 환경에서 AI 에이전트가 조직의 지식 베이스에 안전하게 접근하고 활용할 수 있도록 설계된 중앙 집중식 플랫폼입니다. MCP를 기본 프로토콜로 채택하여 다양한 AI 도구와의 호환성을 보장하며, 자체 호스팅 방식으로 데이터 주권과 보안을 완벽하게 통제할 수 있습니다.
주요 기능
- RAG 컨텍스트 관리: 문서 업로드, 인덱싱, 청킹 및 의미 기반 검색 지원
- 접근 정책: 역할 기반 접근 제어(RBAC)를 통한 세분화된 권한 관리
- AI 스킬 저장소: 재사용 가능한 AI 스킬 템플릿 및 워크플로우 관리
- MCP 호환성: Claude, Cursor, Codex 등 MCP를 지원하는 모든 AI 도구와 통합
- 감사 로깅: 모든 지식 접근 및 변경 사항에 대한 완전한 추적 가능성
- 자체 호스팅: Docker Compose 기반의 간편한 배포 및 운영
빠른 시작
사전 요구 사항
- Docker 및 Docker Compose 설치
- 최소 4GB RAM, 20GB 디스크 공간
- (선택 사항) OpenAI API 키 또는 기타 LLM 제공업체 키
설치
git clone https://github.com/nduckmink/arkon.git
cd arkon
docker compose up -d
구성
환경 변수 파일(.env)을 생성하고 다음을 설정합니다:
ARKON_API_KEY=your-secure-api-key
ARKON_STORAGE_PATH=./data
MCP_ENABLED=true
MCP 클라이언트 연결
MCP를 지원하는 클라이언트(예: Claude Desktop)에서 다음 구성을 추가합니다:
{
"mcpServers": {
"arkon": {
"command": "npx",
"args": ["-y", "@arkon/mcp-server"],
"env": {
"ARKON_API_KEY": "your-api-key",
"ARKON_ENDPOINT": "http://localhost:3000"
}
}
}
}
사용 예시
문서 업로드
curl -X POST http://localhost:3000/api/documents \
-H "Authorization: Bearer $ARKON_API_KEY" \
-F "[email protected]" \
-F "metadata={\"department\": \"engineering\"}"
지식 검색
curl http://localhost:3000/api/search?q="배포 프로세스"&limit=5 \
-H "Authorization: Bearer $ARKON_API_KEY"
API 문서
| 엔드포인트 | 메서드 | 설명 |
|---|---|---|
/api/documents | POST | 새 문서 업로드 |
/api/documents | GET | 문서 목록 조회 |
/api/search | GET | 의미 기반 검색 |
/api/contexts | POST | RAG 컨텍스트 생성 |
/api/skills | GET | AI 스킬 목록 조회 |
보안
- 모든 API 통신은 TLS 암호화 권장
- API 키 기반 인증
- 역할 기반 접근 제어 (admin, editor, viewer)
- 감사 로그: 모든 읽기/쓰기 작업 기록
- 데이터 암호화: 저장 데이터 AES-256 암호화
기여하기
버그 리포트, 기능 제안 및 풀 리퀘스트는 GitHub 저장소를 통해 환영합니다: https://github.com/nduckmink/arkon
라이선스
MIT License
Copyright (c) 2024 nduckmink
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.