Fresh JavaScript

🚀 JavaScript MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）用の JavaScript 実行サーバーです。AI モデルが MCP ツールを通じて JavaScript コードを実行できるようにします。

🚀 クイックスタート

JavaScript MCP サーバーを使用することで、AI モデルが MCP を介して JavaScript コードを実行できます。以下に、インストールと使用方法を説明します。

✨ 主な機能

• JavaScript 実行：JavaScript コードを一度限りのスクリプト実行モードで実行します。
• REPL セッション：複数のインタラクションにまたがる状態を維持する REPL セッションを管理します。
• TypeScript サポート：TypeScript コードを実行し、自動的にトランスパイルします。
• NPM 統合：npm パッケージを動的にインポートして使用できます。
• インタラクティブモード：直接的なコマンドライン REPL インターフェイスを提供し、インタラクションが可能です。
• 名前付きパイプインターフェイス：名前付きパイプを通じて外部プロセスと通信できます。

📦 インストール

# リポジトリをクローン
git clone https://github.com/yannbam/fresh-js-mcp.git
cd fresh-js-mcp

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

💻 使用例

基本的な使用法

# 標準モードで MCP サーバーを起動
npm start

# インタラクティブな REPL モードで起動
node dist/index.js --interactive

# 名前付きパイプインターフェイスで起動
node dist/index.js --pipe

# すべてのオプションを表示
node dist/index.js --help

高度な使用法

実行モード

サーバーは3つの実行モードをサポートしています。

1. 標準 MCP モード（デフォルト）：標準入出力を通じてモデルコンテキストプロトコルで通信します。
2. インタラクティブモード：REPL インターフェイスを提供し、ユーザーが直接インタラクションできます。
3. パイプモード：名前付きパイプを使用して外部プロセスと通信します。 これらのモードの詳細については、examples ディレクトリを参照してください。

利用可能なツール

• execute：JavaScript コードを一度実行し、結果を返します。
• createSession：新しい REPL セッションを作成します。
• executeInSession：既存のセッションでコードを実行します。
• listSessions：すべてのアクティブな REPL セッションをリストします。
• deleteSession：REPL セッションを削除します。

🔧 技術詳細

JavaScript MCP サーバーは、次のような階層化されたアーキテクチャに従っています。

1. MCP プロトコル層：クライアントとの通信を処理します。
2. JavaScript 実行層：隔離された環境でコードを実行します。
3. リソース管理層：パッケージと TypeScript を管理します。
4. セッション管理層：状態を永続化する REPL セッションを維持します。

📄 ライセンス

MIT