Langchain MCP Tools Ts

🚀 MCP ツールボックス

MCP（Model Configuration Protocol）ツールボックスは、モデル構成プロトコルに関連するワークフローを簡素化することを目的としています。これにより、ユーザーは設定ファイルまたはコマンドライン引数を使用して、MCP サーバーを簡単に起動および管理し、一貫したインターフェースを通じてこれらのサーバーと相互作用することができます。

🚀 クイックスタート

ローカル MCP サーバーの設定

設定ファイルまたはコマンドライン引数を使用して、ローカルの MCP サービスを起動できます。例えば：

const config = {
    "local-server": {
        command: 'node my-mcp-server.js',
        args: ['--port', '3000']
    }
};

// サーバーを起動
mcpToolbox.start(config);

リモート MCP サービスへの接続

リモートの MCP サービスに接続するには、設定ファイルで URL を指定するだけです。

const config = {
    "remote-server": {
        url: 'http://example.com/mcp'
    }
};

// リモートサーバーに接続
mcpToolbox.connect(config);

✨ 主な機能

• 設定ファイルまたはコマンドライン引数を使用して、MCP サーバーを簡単に起動および管理することができます。
• 一貫したインターフェースを通じて、MCP サーバーと相互作用することができます。
• ローカルおよびリモートの MCP サービスをサポートしています。
• 認証機能やエラー出力のリダイレクトなどの高度な設定が可能です。

📦 インストール

npm または yarn を使用して、MCP ツールボックスをインストールできます。

npm install mcp-toolbox
# または
yarn add mcp-toolbox

インストールが完了したら、任意の JavaScript ファイルでインポートして使用できます。

const mcpToolbox = require('mcp-toolbox');
// または
import { default as mcpToolbox } from 'mcp-toolbox';

💻 使用例

基本的な使用法

ローカルサーバーを起動し、ログをキャプチャする例です。

const mcpToolbox = require('mcp-toolbox');
const fs = require('fs');

// ログファイルの記述子を作成
const logFd = fs.openSync('mcp-server.log', 'w');

const config = {
    "local-mcp": {
        command: './server.js',
        args: ['--mode', 'production'],
        cwd: '/path/to/working/dir',
        stderr: logFd
    }
};

// サーバーを起動
mcpToolBox.start(config);

高度な使用法

OAuth 認証が必要なリモートサービスに接続する例です。

const mcpToolbox = require('mcp-toolbox');
const { MyOAuthProvider } = require('./auth');

const config = {
    "remote-mcp": {
        url: 'https://example.com/mcp',
        sseOptions: {
            authProvider: new MyOAuthProvider()
        }
    }
};

// リモートサーバーに接続
mcpToolbox.connect(config);

📚 ドキュメント

基本設定

• command: ローカルの MCP サービスを起動するコマンドです。
• args: コマンドに渡す引数の配列です。
• url: リモートの MCP サービスの URL です。

高度な設定

• cwd: コマンドを実行する際の作業ディレクトリです。
• stderr: エラー出力をキャプチャするファイル記述子です。
• authProvider: 認証が必要なサービスの場合、カスタムの認証プロバイダーを提供します。

🔧 技術詳細

リモート MCP サービスのサポート

SSE（Server-Sent Events）または WebSocket を介して提供されるリモート MCP サービスをサポートしています。

const config = {
    "sse-server": {
        url: `http://${sse_server_host}:${sse_server_port}`
    },
    "websocket-server": {
        url: `ws://${websocket_server_host}:${websocket_server_port}`
    }
};

認証のサポート

MCP サービスに認証が必要な場合は、カスタムの認証プロバイダーを使用して実装できます。

class MyOAuthProvider {
    authenticate() {
        // 認証ロジックを実装
    }
}

const config = {
    "remote-server": {
        url: 'http://protected.example.com/mcp',
        sseOptions: {
            authProvider: new MyOAuthProvider()
        }
    }
};

エラー出力のリダイレクト

stderr 属性を指定することで、エラー出力をカスタムファイルまたはストリームにリダイレクトできます。

const fs = require('fs');
const config = {
    "local-server": {
        command: 'node my-server.js',
        stderr: fs.openSync('error.log', 'w')
    }
};

📄 制限事項

• 現在は、Node.js で起動されるローカルの MCP サービスのみがサポートされています。
• リモートサービスについては、現在は SSE と WebSocket プロトコルのみがサポートされています。

📈 変更履歴

v1.0.0（2023-10-01）

• 基本機能とドキュメントを含む初期バージョンをリリースしました。

v1.1.0（2023-11-01）

• WebSocket のサポートを追加しました。
• エラー処理メカニズムを最適化しました。

📚 ドキュメント

詳細情報については、MCP ツールボックスのドキュメントを参照してください。