@huggingface/mcp-client

Model Context Protocol (MCP) 客戶端。

此軟體包提供了與 MCP 伺服器互動的客戶端實現，它基於我們的 InferenceClient，即 @huggingface/inference。

它包含一個可以利用 MCP 工具的 CLI smol Agent 示例。

安裝

此軟體包是 Hugging Face JS Monorepo 的一部分。要安裝所有軟體包的依賴項，請在倉庫根目錄執行：

pnpm install

用法 (CLI Agent)

該軟體包包含一個命令列介面 (CLI) 代理，用於演示如何使用 MCP 客戶端。

先決條件

• Hugging Face API 令牌：您需要一個具有適當許可權的 Hugging Face API 令牌。將其設定為環境變數：
  已複製

  export HF_TOKEN="hf_..."

執行代理

導航到軟體包目錄並執行代理指令碼：

cd packages/mcp-client
pnpm agent

或者，從 monorepo 的根目錄執行：

pnpm --filter @huggingface/mcp-client agent

代理將載入可用的 MCP 工具（預設情況下，連線到桌面檔案系統伺服器和 Playwright 伺服器），並提示您輸入（>）。

配置（環境變數）

• HF_TOKEN（可選）：您的 Hugging Face API 令牌。如果您在 HF 上使用推理提供商，則需要此項。
• MODEL_ID（可選）：用於代理推理的模型 ID。預設為 Qwen/Qwen2.5-72B-Instruct。
• PROVIDER（可選）：推理提供商。預設為 together。有關可用提供商，請參閱 @huggingface/inference。
• ENDPOINT_URL 或 BASE_URL（可選）：要呼叫的自定義基本 URL（例如本地 URL）。

使用自定義模型示例：

export HF_TOKEN="hf_..."
export MODEL_ID="Qwen/Qwen2.5-72B-Instruct"
pnpm agent

開發

常見的開發任務可以使用 pnpm 指令碼執行：

• pnpm build：構建軟體包。
• pnpm lint：檢查並修復程式碼風格。
• pnpm format：使用 Prettier 格式化程式碼。
• pnpm test：使用 Vitest 執行測試。
• pnpm check：使用 TypeScript 進行型別檢查。

許可證

MIT