MCP 代理 TypeScript 端口

概述

MCP（模型上下文协议）代理 TypeScript 端口是一个强大且类型安全的 MCP 代理系统实现。它提供了一个灵活的框架，用于构建智能的上下文感知代理，具有高级工作流管理、日志记录和执行功能。

这是 lastmile-ai 的原始 MCP Agent 框架的 TypeScript 端口。

特性

• 🚀 模块化架构

  • 全面的 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

快速入门

创建工作流

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('任务完成');
});

配置

MCP Agent 支持以下配置方式：

• 环境变量：通过设置环境变量来配置代理行为。
• 配置文件：使用 JSON 或 YAML 文件进行配置。
• 编程式配置：在代码中直接配置代理选项。

项目状态

该项目目前处于早期开发阶段。欢迎贡献代码、报告问题或提出建议。

原始项目链接

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

许可证

MCP Agent 按照 MIT License 分发。