MCP Agent TypeScript Port

Overview

The MCP (Model Context Protocol) Agent TypeScript Port is a robust type-safe implementation of the MCP Agent system. It provides a flexible framework for building intelligent context-aware agents with advanced workflow management, logging, and execution capabilities.

This is a TypeScript port of the original MCP Agent framework by lastmile-ai.

Features

🚀 Modular Architecture
- Comprehensive TypeScript implementation
- Flexible, extensible design
- Type-safe interfaces
📊 Advanced Workflow Management
- Step-based workflow execution
- Concurrent task processing
- Detailed context tracking
🔍 Powerful Logging System
- Configurable log levels
- Context-rich logging
- Log export capabilities
🧰 Flexible Executor
- Task queuing
- Timeout handling
- Concurrent task management
🖥️ CLI Support
- Command-line interface
- Easy agent management

Installation

Installing via Smithery

To install MCP Agent TypeScript Port for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install @waldzell/mcp-agent-ts

Quick Start

Creating a Workflow

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

class MyDataProcessingWorkflow extends BaseWorkflow {
  constructor() {
    super('my-workflow', 'Data Processing');

    this.addStep({
      id: 'extract',
      name: 'Data Extraction',
      execute: async (context) => {
        // Implement data extraction logic
        return { data: ['item1', 'item2'] };
      }
    });

    this.addStep({
      id: 'transform',
      name: 'Data Transformation',
      execute: async (context) => {
        // Implement data transformation logic
        return { transformedData: ['ITEM1', 'ITEM2'] };
      }
    });
  }
}

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

Logging

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

// Log with different levels
debug('Debugging information', { userId: 123 });
info('System started');
warn('Potential issue detected');
error('Critical error occurred');

CLI Usage

# Start the MCP Agent
npx mcp-agent start

# List available tools
npx mcp-agent list-tools

# Set log level
npx mcp-agent log-level debug

Executor Usage

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

const executor = new BaseExecutor({ 
  maxConcurrentTasks: 3,
  timeout: 60000 // 1-minute timeout
});

const task: Task = {
  id: 'example-task',
  name: 'Sample Task',
  execute: async () => {
    // Task implementation
    return 'Task completed';
  }
};

await executor.enqueueTask(task);

Configuration

The MCP Agent can be configured through:

Environment variables
Configuration files
Programmatic configuration

Development Status

🚧 Early Stage Development 🚧

This is an early-stage port and is not yet feature-complete. Contributions and feedback are welcome!

Original Project

Original MCP Agent: lastmile-ai/mcp-agent

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

This project follows the license of the original MCP Agent project, found here.

Acknowledgements

Special thanks to the original MCP Agent developers for creating an innovative framework for AI agent development.

This server cannot be installed

security - not tested

license - not found

quality - not tested

A TypeScript implementation of the MCP Agent framework, providing tools for building context-aware agents with advanced workflow management, logging, and execution capabilities.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Inception MCP Server
tanevanwifferen
A
security
A
license
A
quality
A TypeScript-based server that allows calling other MCP clients from your own MCP client, facilitating task delegation and context window offloading for enhanced multi-agent interactions.
Last updated -
3
14
JavaScript
MIT License
Dify Workflows MCP Server
localSummer
-
security
F
license
-
quality
A TypeScript implementation of a Model Context Protocol (MCP) server that exposes Dify workflows as tools for AI systems to interact with.
Last updated -
16
TypeScript
WithSeismic MCP
dougwithseismic
-
security
A
license
-
quality
A TypeScript implementation of a Model Context Protocol server that provides a frictionless framework for developers to build and deploy AI tools and prompts, focusing on developer experience with zero boilerplate and automatic tool registration.
Last updated -
6
TypeScript
MIT License
MCP Server for Agent8
planetarium
A
security
F
license
A
quality
A server implementing the Model Context Protocol (MCP) to support Agent8 SDK development by providing system prompts and code example search capabilities through stdio and SSE transports.
Last updated -
8
TypeScript

View all related MCP servers

MCP Agent TypeScript Port