MCP Agent TypeScript Port

by waldzellai

Integrations

  • Supports contribution workflow through Git, including branching and pull requests

  • References the original project on GitHub and provides GitHub-based contribution workflow

  • Allows installation of the MCP Agent TypeScript port via npm package manager

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. 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.

-
security - not tested
F
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.

  1. Overview
    1. Features
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
      2. Quick Start
        1. Creating a Workflow
        2. Logging
        3. CLI Usage
      3. Executor Usage
        1. Configuration
          1. Development Status
            1. Original Project
              1. Contributing
                1. License
                  1. Acknowledgements

                    Related MCP Servers

                    • 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
                      • Apple
                    • -
                      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 -
                      9
                      TypeScript
                    • -
                      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
                    • 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
                      • Apple
                      • Linux

                    View all related MCP servers

                    ID: lamjyav2ov