@torchv/ais-mcp

English | 中文

🚀 TorchV AIS 지식 베이스 MCP 서버

AIS 엔터프라이즈 지식 베이스에서 직접 읽기 / 쓰기 / 편집 / 파일 전송 작업을 수행할 수 있는 프로덕션 준비 완료 MCP 서버입니다.

✨ 주요 기능

• 📚 AIS 지식 베이스에 대한 통합 액세스

• 🛠️ 전체 MCP 툴체인 (읽기 / 쓰기 / 관리)

• ⚡ npx를 통한 원명령어 실행

• 🔌 STDIO 및 HTTP (스트리밍 가능) 전송 방식 모두 지원

• 🔐 세밀한 권한 제어 (readonly / write / admin)

🚀 설치 및 실행

npx -y @torchv/ais-mcp

🔑 필수 구성

시작하기 전에 다음 환경 변수를 설정하십시오:

export KB_EXECUTE_URL="https://bot.torchv.com"
export KB_TOKEN="your-token"

🌐 KB_EXECUTE_URL을 얻는 방법

📌 단계:

1. AIS 인스턴스를 엽니다.

2. 브라우저 주소 표시줄에서 사이트 오리진(origin)을 복사합니다.

👉 예시:

https://bot.torchv.com

🔐 KB_TOKEN을 얻는 방법

권장 사항:

AIS → Admin Center → API Keys → Create Key

임시 (프로덕션 환경에는 권장하지 않음):

Browser DevTools → Network → Inspect request → Copy token

⚙️ 선택적 구성

export KB_MODE="readonly"   # readonly | write | admin
export KB_TIMEOUT_SECONDS="30"
export KB_DEFAULT_REPO_CODE="TEAM_DOCS"
export KB_EXTRA_HEADERS_JSON='{"x-foo":"bar"}'

🛡️ 권한 수준

• 🟢 readonly → 읽기 전용 액세스

• 🟡 write → 쓰기 / 업로드 / 게시 허용

• 🔴 admin → 전체 제어 (이동 / 삭제)

🧩 실행 모드

🖥️ STDIO 모드 (로컬 MCP 클라이언트)

npm run build
node dist/cli.js

또는:

npm run dev
npm run start

🌍 스트리밍 가능한 HTTP 모드

npm run build
node dist/cli.js \
  --transport streamable-http \
  --host 127.0.0.1 \
  --port 3000 \
  --path /mcp

또는:

npm run dev:http
npm run start:http

📌 매개변수:

--transport streamable-http
--host 127.0.0.1
--port 3000
--path /mcp

🔌 Claude / Codex 구성

STDIO

{
  "mcpServers": {
    "ais": {
      "command": "npx",
      "args": ["-y", "@torchv/ais-mcp"],
      "env": {
        "KB_EXECUTE_URL": "https://your-ais-domain",
        "KB_TOKEN": "your-token",
        "KB_MODE": "readonly"
      }
    }
  }
}

HTTP 모드

{
  "mcpServers": {
    "ais-http": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3000/mcp"
    }
  }
}

🛠️ 도구 개요

📖 읽기 전용

• kb_list_repos

• kb_list_path

• kb_tree

• kb_search

• kb_read_document

• kb_render_link

• kb_download_file

• kb_get_download_link

✏️ 쓰기

• kb_write_document

• kb_patch_document

• kb_create_directory

• kb_copy_document

• kb_publish_document

• kb_upload_file

🔧 관리자

• kb_move_document

• kb_delete_document

🧠 AIS 소개

AIS는 TorchV의 핵심 제품으로, 단순한 전통적 지식 베이스가 아닌 다음을 제공합니다:

🧠 엔터프라이즈 AI 지식 엔진

핵심 역량

• 🔄 분산된 데이터를 구조화된 지식으로 변환

• 🔍 검색 가능

• 🧩 관리 가능

• ⚡ 구성 가능

• 📈 최적화 가능

🎁 AIS 체험하기

📲 문의 (CEO 위챗):