Langchain MCP Tools Ts

🚀 MCP 工具箱

MCP 工具箱主要用於簡化與模型配置協議相關的工作流程。用戶能借助配置文件或命令行參數，輕鬆啟動和管理 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);

📚 詳細文檔

基本配置

高級配置

🔧 技術細節

實驗性功能

遠程 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 工具箱文檔。