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 エージェントを起動
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 を通じて、Claude Desktop で使用する MCP Agent TypeScript ポートを自動インストールするには：

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

手動インストール

npm install @waldzell/mcp-agent-ts

📚 ドキュメント

設定

MCP エージェントは、以下の設定方法をサポートしています：

• 環境変数：環境変数を設定することで、エージェントの動作を設定します。
• 設定ファイル：JSON または YAML ファイルを使用して設定します。
• プログラムによる設定：コード内で直接エージェントのオプションを設定します。

プロジェクトの状態

このプロジェクトは現在、初期開発段階にあります。コードの貢献、問題の報告、または提案を歓迎します。

オリジナルプロジェクトのリンク

https://github.com/lastmile-ai/mcp-agent

📄 ライセンス

MCP エージェントは MIT License に基づいて配布されています。