mcp-agent

Overview

mcp-agent is a TypeScript framework inspired by the Python mcp-agent project, providing a simple, composable way to build AI agents leveraging the Model Context Protocol. It offers agent abstraction, MCP server integration, local function tools, and various workflow patterns like the Orchestrator pattern. The framework features a two-layer architecture with a global Connection Manager and per-Agent Aggregator for efficient resource management.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• read_file_from_local_file_system

  Reads files from the local file system

  Try:Read the contents of document.txtTry:Show me the config file in the project directory
• search_web

  Searches the web using an external API

  Try:Find the latest news about AITry:Search for information about TypeScript best practices
• writeLocalSystem

  Writes information to a local file

  Try:Save the research results to theory_on_ai.mdTry:Write the summary to a report.txt file

Note: Tool names were inferred from the example configuration in the README, which shows MCP server configurations being used. The exact signatures and detailed descriptions are not documented in the provided text.

Comparable tools

Installation

npm install @joshuacalpuerto/mcp-agent

{
  "mcpServers": {
    "mcp-agent": {
      "command": "node",
      "args": ["--loader", "ts-node/esm", "/path/to/your/mcp-agent/index.ts"]
    }
  }
}

FAQ

What is the difference between mcp-agent and the original Python version?

The TypeScript version brings the same patterns and architecture to JavaScript/TypeScript environments, offering type safety and integration with existing Node.js applications. The core concepts remain the same.

How does the Connection Manager + Aggregator architecture work?

The Connection Manager maintains a global pool of MCP server connections to avoid duplication. Each Agent has its own Aggregator that provides access to specific tools from the global pool, enabling connection reuse while maintaining isolation.

Compare mcp-agent with