@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. ブラウザのアドレスバーからサイトのオリジンをコピーする

👉 例：

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 WeChat）：