@torchv/ais-mcp

Inglés | 中文

🚀 Servidor MCP de Base de Conocimiento TorchV AIS

Un servidor MCP listo para producción que permite operaciones de lectura / escritura / edición / transferencia de archivos directamente en la base de conocimiento empresarial de AIS.

✨ Características

• 📚 Acceso unificado a la base de conocimiento de AIS

• 🛠️ Cadena de herramientas MCP completa (lectura / escritura / gestión)

• ⚡ Inicio con un comando mediante npx

• 🔌 Admite transportes STDIO y HTTP (streamable)

• 🔐 Control de permisos detallado (readonly / write / admin)

🚀 Instalación y ejecución

npx -y @torchv/ais-mcp

🔑 Configuración requerida

Antes de comenzar, establezca las siguientes variables de entorno:

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

🌐 Cómo obtener KB_EXECUTE_URL

📌 Pasos:

1. Abra su instancia de AIS

2. Copie el origen del sitio desde la barra de direcciones del navegador

👉 Ejemplo:

https://bot.torchv.com

🔐 Cómo obtener KB_TOKEN

Recomendado:

AIS → Admin Center → API Keys → Create Key

Temporal (no recomendado para producción):

Browser DevTools → Network → Inspect request → Copy token

⚙️ Configuración opcional

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"}'

🛡️ Niveles de permisos

• 🟢 readonly → Acceso de solo lectura

• 🟡 write → Permite escritura / carga / publicación

• 🔴 admin → Control total (mover / eliminar)

🧩 Modos de ejecución

🖥️ Modo STDIO (Cliente MCP local)

npm run build
node dist/cli.js

o:

npm run dev
npm run start

🌍 Modo HTTP Streamable

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

o:

npm run dev:http
npm run start:http

📌 Parámetros:

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

🔌 Configuración de 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"
      }
    }
  }
}

Modo HTTP

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

🛠️ Descripción general de las herramientas

📖 Solo lectura

• kb_list_repos

• kb_list_path

• kb_tree

• kb_search

• kb_read_document

• kb_render_link

• kb_download_file

• kb_get_download_link

✏️ Escritura

• kb_write_document

• kb_patch_document

• kb_create_directory

• kb_copy_document

• kb_publish_document

• kb_upload_file

🔧 Administrador

• kb_move_document

• kb_delete_document

🧠 Acerca de AIS

AIS es el producto principal de TorchV, no solo una base de conocimiento tradicional, sino:

🧠 Un motor de conocimiento de IA empresarial

Capacidades principales

• 🔄 Transformar datos dispersos → conocimiento estructurado

• 🔍 Buscable

• 🧩 Gobernable

• ⚡ Componible

• 📈 Optimizable

🎁 Pruebe AIS

📲 Contáctenos (WeChat del CEO):