Easy MCP Use

Easy-MCP-Use是一個開源的TypeScript庫，旨在連接任何LLM到任何MCP服務器，並構建具有工具訪問權限的自定義代理。它支持多種LLM模型和MCP服務器，提供動態服務器選擇、多服務器支持、工具限制等功能，使開發者能夠輕鬆地將LLM連接到各種工具。

開發者工具人工智能聊天機器人 #LLM連接 #工具訪問 #多服務器 #TypeScript .TypeScript

評分 : 2分

下載量 : 9

更新時間 : 2025-04-28

什麼是MCP服務器？

MCP服務器是一種用於連接任何大語言模型（LLM）到外部工具（如網絡瀏覽、文件操作等）的中間件。它使開發者能夠輕鬆地構建具有工具訪問能力的自定義智能代理。

如何使用MCP服務器？

通過簡單的幾行代碼即可將MCP服務器集成到你的項目中，支持多種編程語言和工具。

適用場景

MCP服務器適用於需要複雜任務處理的應用場景，例如網絡搜索、文件管理、圖像生成等。

主要功能

易用性只需幾行代碼即可創建一個支持MCP的智能代理。

LLM靈活性支持任何LangChain支持的LLM，包括OpenAI、Anthropic、Groq等。

HTTP支持直接連接到運行在特定HTTP端口上的MCP服務器。

動態服務器選擇智能代理可以根據任務需求動態選擇最合適的MCP服務器。

多服務器支持在同一代理中同時使用多個MCP服務器。

工具限制限制潛在危險的工具，如文件系統或網絡訪問。

類型安全完全支持TypeScript，所有API和配置均帶有類型定義。

優勢與侷限性

優勢

開放源碼，無需依賴封閉式應用客戶端。

支持廣泛的LLM和工具。

易於集成到現有項目中。

強大的動態服務器選擇功能。

全面的TypeScript支持。

侷限性

需要一定的編程基礎來設置和使用。

某些高級功能可能需要額外的配置。

對於大規模部署可能需要更高的硬件資源。

如何使用

安裝MCP庫

通過npm安裝MCP庫。

配置MCP服務器

編輯配置文件以指定MCP服務器地址。

創建代理

使用配置好的MCP客戶端創建代理。

使用案例

網絡瀏覽示例使用Playwright進行網頁瀏覽。

多服務器支持示例同時使用多個MCP服務器執行任務。

常見問題

MCP服務器是否支持所有LLM？

如何確保工具的安全性？

MCP服務器是否支持TypeScript？

🚀 MCP-Use-TS

MCP-Use-TS 是一個專為 TypeScript 打造的 MCP 庫。它能讓你輕鬆配置並連接多個 MCP 服務器，還能在項目中便捷使用這些服務器。該庫旨在簡化與不同 MCP 實現（如 Playwright MCP）的集成，讓你能更專注於業務邏輯的實現。

如果你有任何問題或建議，歡迎隨時提出 issue 或 pull request。

🚀 快速開始

項目配置

在你的 TypeScript 項目裡創建一個 mcp-config.ts 文件：

import type { MCPConfig } from 'mcp-use-typscript';

const config: MCPConfig = {
  servers: [
    {
      name: 'playwright',
      command: 'npx',
      args: ['@playwright/mcp', '--version'],
      options: {
        cwd: '.',
        stdio: 'inherit'
      }
    },
    {
      name: 'airbnb',
      command: 'npx',
      args: ['-y', '@openfb/mcp-server-airbnb']
    }
  ]
};

export default config;

啟動 MCP 服務器

在項目根目錄下創建一個 start-mcp.ts 文件：

import { startMCP } from 'mcp-use-typscript';

async function main() {
  await startMCP();
}

main().catch(console.error);

運行以下命令啟動 MCP 服務器：

npm run start-mcp

使用示例

在 TypeScript 文件中導入並使用 MCP 客戶端和代理：

import { createMCPClient, createMCPAgent } from 'mcp-use-typscript';

async function main() {
  const client = await createMCPClient();
  const agent = createMCPAgent({
    client,
    llm: new LLM(),
    verbose: true
  });

  const result = await agent.run('你的任務指令');
  console.log(result);
}

main().catch(console.error);

✨ 主要特性

支持同時連接多個 MCP 服務器。
提供靈活的配置選項，可自定義每個服務器的啟動參數。
內置代理功能，便於在項目中管理和使用不同的 MCP 服務。

📦 安裝指南

npm install mcp-use-typscript

📚 詳細文檔

配置文件格式

你的配置文件應包含以下內容：

interface MCPConfig {
  servers: Array<{
    name: string;
    command: string;
    args?: string[];
    options?: Record<string, unknown>;
  }>;
}

創建代理

你可以通過 createMCPAgent 函數創建一個代理實例。這個代理將連接到所有配置中的服務器，並根據需要選擇合適的工具來執行任務。

💻 使用示例

基礎用法

配置多個服務器

在項目的配置文件中定義多個 MCP 服務器：

{
  "mcpConfig": {
    "servers": [
      {
        "name": "playwright",
        "command": "npx",
        "args": ["@playwright/mcp", "--version"],
        "options": {
          "cwd": ".",
          "stdio": "inherit"
        }
      },
      {
        "name": "airbnb",
        "command": "npx",
        "args": ["-y", "@openfb/mcp-server-airbnb"]
      }
    ]
  }
}

創建代理

在 TypeScript 文件中，使用以下代碼創建代理：

import { createMCPClient, createMCPAgent } from 'mcp-use-typscript';

async function main() {
  const client = await createMCPClient();
  const agent = createMCPAgent({
    client,
    llm: new LLM(),
    verbose: true
  });

  const result = await agent.run('你的任務指令');
  console.log(result);
}

main().catch(console.error);