@torchv/ais-mcp

Englisch | Chinesisch

🚀 TorchV AIS Wissensdatenbank MCP-Server

Ein produktionsbereiter MCP-Server, der Lese- / Schreib- / Bearbeitungs- / Dateiübertragungs- Vorgänge direkt in der AIS Enterprise-Wissensdatenbank ermöglicht.

✨ Funktionen

• 📚 Einheitlicher Zugriff auf die AIS-Wissensdatenbank

• 🛠️ Vollständige MCP-Toolchain (Lesen / Schreiben / Verwaltung)

• ⚡ Start mit einem Befehl über npx

• 🔌 Unterstützt sowohl STDIO- als auch HTTP (streamable)-Transporte

• 🔐 Fein abgestufte Berechtigungskontrolle (readonly / write / admin)

🚀 Installation & Ausführung

npx -y @torchv/ais-mcp

🔑 Erforderliche Konfiguration

Legen Sie vor dem Start die folgenden Umgebungsvariablen fest:

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

🌐 So erhalten Sie KB_EXECUTE_URL

📌 Schritte:

1. Öffnen Sie Ihre AIS-Instanz

2. Kopieren Sie den Site-Origin aus der Adressleiste des Browsers

👉 Beispiel:

https://bot.torchv.com

🔐 So erhalten Sie KB_TOKEN

Empfohlen:

AIS → Admin Center → API Keys → Create Key

Temporär (nicht für die Produktion empfohlen):

Browser DevTools → Network → Inspect request → Copy token

⚙️ Optionale Konfiguration

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

🛡️ Berechtigungsstufen

• 🟢 readonly → Schreibgeschützter Zugriff

• 🟡 write → Erlaubt Schreiben / Hochladen / Veröffentlichen

• 🔴 admin → Volle Kontrolle (Verschieben / Löschen)

🧩 Ausführungsmodi

🖥️ STDIO-Modus (Lokaler MCP-Client)

npm run build
node dist/cli.js

oder:

npm run dev
npm run start

🌍 Streambarer HTTP-Modus

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

oder:

npm run dev:http
npm run start:http

📌 Parameter:

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

🔌 Claude / Codex-Konfiguration

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-Modus

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

🛠️ Tool-Übersicht

📖 Schreibgeschützt

• kb_list_repos

• kb_list_path

• kb_tree

• kb_search

• kb_read_document

• kb_render_link

• kb_download_file

• kb_get_download_link

✏️ Schreiben

• kb_write_document

• kb_patch_document

• kb_create_directory

• kb_copy_document

• kb_publish_document

• kb_upload_file

🔧 Admin

• kb_move_document

• kb_delete_document

🧠 Über AIS

AIS ist das Kernprodukt von TorchV – nicht nur eine traditionelle Wissensdatenbank, sondern:

🧠 Eine Enterprise-KI-Wissensmaschine

Kernfähigkeiten

• 🔄 Verwandelt verstreute Daten → strukturiertes Wissen

• 🔍 Durchsuchbar

• 🧩 Steuerbar

• ⚡ Kombinierbar

• 📈 Optimierbar

🎁 AIS ausprobieren

📲 Kontaktieren Sie uns (CEO WeChat):