Klura

@klura/mcp

@klura/runtime 用の MCP（Model Context Protocol）サーバーです。まず、メンテナンスされたローカルのウェブデータツールを公開し、ブラウザーによる探索とツール作成は、ユーザーから明示的に求められた場合にのみ利用できます。

@klura/runtime は、モデルキーなしで署名済みのローカルツールを検索、インストール、呼び出し、実行します。別途用意されたファクトリーでは、ブラウザー操作を観察してツールをマッピングし、メンテナンスできます。@klura/mcp は、両方の機能を MCP 経由で提供する薄いラッパーです。

インストール

npm install -g @klura/mcp

@klura/runtime パッケージは依存関係として宣言され、併せてインストールされます。ランタイムは初回使用時にローカルデーモンを自動起動し、学習した内容をすべて ~/.klura/ に保存します。

接続方法

MCP クライアントの設定にサーバーを追加してください。正確なファイルパスはクライアントによって異なりますが、サーバーの定義は同じです。

{
  "mcpServers": {
    "klura": {
      "command": "npx",
      "args": ["-y", "@klura/mcp"]
    }
  }
}

クライアントを再起動してください。エージェントは klura ツールセットを自動的に認識します。

公開する機能

エージェントのコンテキストに、次の2つの機能を提供します。

• メンテナンスされたローカルツール — search_packages、install_package、call_package_capability、start_scrape_run および関連する実行／セッション用ツールを通じて、署名済みパッケージを検索、調査、インストール、呼び出し、実行、調査できます。対象への通信と出力はユーザーのマシン内にとどまります。
• 明示的なツール作成 — ブラウザー自動化（start_session、perform_action、get_screenshot、get_a11y_tree）、探索と永続化（save_strategy、execute、list_platform_skills、get_strategy）、ネットワークログの調査（get_network_log、find_in_page）、およびリバースエンジニアリングツールを利用できます。正規の一覧はランタイムが管理し、このサーバーはその一覧をそのまま反映します。
• リソース klura://reference — 詳細なリファレンスドキュメントです。URL フラグメント（klura://reference#reverse-engineer-playbook、klura://reference#recorded-path-schema など）を使ってセクション単位で提供されるため、各レスポンスを MCP の出力予算内に収められます。フラグメントを付けずに klura://reference を取得すると、目次が表示されます。

常に読み込まれるガイダンスは SKILL.md で、サーバーの instructions ケイパビリティとして渡されます。エージェントは会話のたびに SKILL.md を読み込み、必要に応じて klura://reference の各フラグメントから詳細を取得します。

仕組み

薄いラッパーとして、各 MCP tools/call を対応する klura ランタイム関数にディスパッチします。デーモンのライフサイクル、ブラウザーセッション、~/.klura/skills/ への戦略の永続化、および実行はランタイムが処理します。

MCP client (Claude Desktop, Cursor, …)
    │  stdio transport, JSON-RPC
    ▼
@klura/mcp (this package)
    │  Node require('@klura/runtime')
    ▼
klura runtime → local daemon → Playwright

ライセンス

BUSL-1.1。LICENSE を参照してください。基盤となる @klura/runtime と同じ条件です。商用利用の条件については、ランタイムの README を参照してください。