mcp-v8

mcp-v8: V8 JavaScript MCP サーバー

ClaudeやCursorなどのAIエージェント向けのツールとしてV8 JavaScriptランタイムを公開する、RustベースのModel Context Protocol（MCP）サーバーです。S3またはローカルファイルシステム経由の永続ヒープスナップショットをサポートし、最新のAI開発環境との統合に対応しています。

特徴

• V8 JavaScript 実行: 安全で分離された V8 エンジンで任意の JavaScript コードを実行します。
• ヒープ スナップショット: 実行間で V8 ヒープ状態を保持および復元し、S3 とローカル ファイル ストレージの両方をサポートします。
• MCP プロトコル: Claude、Cursor、およびその他の MCP クライアントとのシームレスなツール統合を実現するモデル コンテキスト プロトコルを実装します。
• 設定可能なストレージ: 実行時にヒープ ストレージとして S3 またはローカル ディレクトリを選択します。

インストール

提供されているインストール スクリプトを使用してmcp-v8をインストールします。

これにより、プラットフォームの最新リリースが/usr/local/bin/mcp-v8に自動的にダウンロードされ、インストールされます (パスワードの入力を求められる場合があります)。

上級ユーザー: ソースからビルドする場合は、このドキュメントの最後にある「ソースからビルド」セクションを参照してください。

コマンドライン引数

mcp-v8次のコマンドライン引数をサポートしています。

• --s3-bucket <bucket> : ヒープスナップショットにAWS S3を使用します。S3バケット名を指定します。( --directory-pathと競合します)
• --directory-path <path> : ヒープスナップショットにローカルディレクトリを使用します。ディレクトリパスを指定します。( --s3-bucketと競合します)

注: --s3-bucketまたは--directory-pathのいずれかを指定する必要があります。どちらも指定されていない場合、サーバーはデフォルトで S3 のバケット名test-mcp-js-bucketを使用します。

クイックスタート

インストール後、サーバーを直接実行できます。以下のいずれかのオプションを選択してください。

統合

デスクトップ版クロード

1. 上記のようにサーバーをインストールします。
2. Claude デスクトップを開き、設定 → 開発者 → 構成の編集を選択します。
3. サーバーをclaude_desktop_config.jsonに追加します。

4. Claude Desktopを再起動します。新しいツールがハンマーアイコンの下に表示されます。

カーソル

1. 上記のようにサーバーをインストールします。
2. プロジェクト ルートに.cursor/mcp.jsonを作成または編集します。

3. カーソルを再起動します。MCP ツールが UI で使用できるようになります。

使用例

• Claude または Cursor に質問します: 「この JavaScript を実行してください: 1 + 2 」
• ヒープ スナップショットを使用して、実行間の状態を保持します。

ヒープストレージオプション

次のコマンドライン引数を使用してヒープ ストレージを構成できます。

• S3 : --s3-bucket <bucket>
  • 例: mcp-v8 --s3-bucket my-bucket-name
  • 環境に AWS 認証情報が必要です。
• ファイルシステム: --directory-path <path>
  • 例: mcp-v8 --directory-path /tmp/mcp-v8-heaps

**注:**一度に使用できるストレージバックエンドは1つだけです。両方指定した場合、サーバーはエラーを返します。

制限事項

mcp-v8強力で永続的な JavaScript 実行環境を提供しますが、そのランタイムには制限があります。

• async / awaitや Promise は使用できません。非同期 JavaScript はサポートされていません。すべてのコードは同期的に記述する必要があります。
• fetchまたはネットワーク アクセスなし: HTTP リクエストを実行したりネットワークにアクセスしたりするための組み込みの方法はありません。
• console.logまたは標準出力が表示されません： console.logや類似の関数からの出力は表示されません。結果を返すには、必要な値がコードの最終行にあることを確認してください。
• ファイル システム アクセスなし: ランタイムは、ローカル ファイル システムまたは環境変数へのアクセスを提供しません。
• npm installまたは外部パッケージが使用できません：npm パッケージのインストールやインポートはできません。標準の JavaScript (ECMAScript) ビルトインのみが利用可能です。
• タイマーなし: setTimeoutやsetIntervalなどの機能は使用できません。
• DOM またはブラウザ API なし: これはブラウザ環境ではないため、 window 、 document 、またはその他のブラウザ固有のオブジェクトにアクセスできません。

ソースからビルド（上級）

インストール スクリプトを使用する代わりにソースからビルドする場合:

前提条件

• Rust（ナイトリーツールチェーン推奨）
• (オプション) S3 ストレージの AWS 認証情報

サーバーを構築する

ビルドされたバイナリはserver/target/release/serverに配置されます。必要に応じて、上記の統合手順で/usr/local/bin/mcp-v8の代わりにこのパスを使用できます。