@torchv/ais-mcp

English | 中文

🚀 MCP-сервер базы знаний TorchV AIS

Готовый к промышленной эксплуатации MCP-сервер, который обеспечивает операции чтения / записи / редактирования / передачи файлов непосредственно в корпоративной базе знаний AIS.

✨ Возможности

• 📚 Единый доступ к базе знаний 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, не просто традиционная база знаний, а:

🧠 Корпоративный движок знаний на базе ИИ

Основные возможности

• 🔄 Преобразование разрозненных данных в структурированные знания

• 🔍 Поиск

• 🧩 Управляемость

• ⚡ Компонуемость

• 📈 Оптимизируемость

🎁 Попробуйте AIS

📲 Свяжитесь с нами (WeChat генерального директора):