MCP Agent Typescript Port

🚀 MCP 代理 TypeScript 端口

MCP（模型上下文協議）代理 TypeScript 端口是一個強大且類型安全的 MCP 代理系統實現，它能提供靈活框架，用於構建智能的上下文感知代理，具備高級工作流管理、日誌記錄和執行功能。

🚀 快速開始

創建工作流

import { BaseWorkflow } from '@waldzell/mcp-agent-ts';

class MyDataProcessingWorkflow extends BaseWorkflow {
  constructor() {
    super('my-workflow', '數據處理');

    this.addStep({
      id: 'extract',
      name: '數據提取',
      execute: async (context) => {
        // 實現數據提取邏輯
        return { data: ['item1', 'item2'] };
      }
    });

    this.addStep({
      id: 'transform',
      name: '數據轉換',
      execute: async (context) => {
        // 實現數據轉換邏輯
        return { transformedData: ['ITEM1', 'ITEM2'] };
      }
    });
  }
}

async function runWorkflow() {
  const workflow = new MyDataProcessingWorkflow();
  const results = await workflow.execute();
  console.log(results);
}

日誌記錄

import { debug, info, warn, error } from '@waldzell/mcp-agent-ts';

// 使用不同級別的日誌
debug('調試信息', { userId: 123 });
info('系統已啟動');
warn('檢測到潛在問題');
error('發生關鍵錯誤');

CLI 使用

# 啟動 MCP Agent
npx mcp-agent start

# 列出可用工具
npx mcp-agent list-tools

# 設置日誌級別
npx mcp-agent log-level debug

執行器使用

import { BaseExecutor, Task } from '@waldzell/mcp-agent-ts';

const executor = new BaseExecutor();

executor.run({
  id: 'task-1',
  name: '示例任務',
  command: 'echo "Hello MCP Agent!"'
}).then(() => {
  console.log('任務完成');
});

✨ 主要特性

• 🚀 模塊化架構

  • 全面的 TypeScript 實現
  • 靈活、可擴展的設計
  • 類型安全的接口

• 📊 高級工作流管理

  • 基於步驟的工作流執行
  • 併發任務處理
  • 詳細的上下文跟蹤

• 🔍 強大的日誌系統

  • 可配置的日誌級別
  • 上下文豐富的日誌記錄
  • 日誌導出功能

• 🧰 靈活的執行器

  • 任務排隊
  • 超時處理
  • 併發任務管理

• 🖥️ CLI 支持

  • 命令行界面
  • 簡易代理管理

📦 安裝指南

使用 Smithery 安裝

要通過 Smithery 自動安裝 MCP Agent TypeScript 端口以供 Claude Desktop 使用：

npx -y @smithery/cli install @waldzellai/mcp-agent-ts --client claude

手動安裝

npm install @waldzell/mcp-agent-ts

📚 詳細文檔

MCP Agent 支持以下配置方式：

• 環境變量：通過設置環境變量來配置代理行為。
• 配置文件：使用 JSON 或 YAML 文件進行配置。
• 編程式配置：在代碼中直接配置代理選項。

📄 許可證

MCP Agent 按照 MIT License 分發。

其他信息

• 這是 lastmile-ai 的原始 MCP Agent 框架的 TypeScript 端口。
• 該項目目前處於早期開發階段。歡迎貢獻代碼、報告問題或提出建議。
•