#3131st of 38 in Agent and MCP starters

mcp-agent

Python framework for building MCP-connected agents with composable workflow patterns

Stars
8.6k
License
Apache-2.0
Last commit
Jan 2026
Last release
May 2025
Language
Python
Stars, last 29 weeks+499
31 Mar 2026: 8,074 stars7 Apr 2026: 8,105 stars14 Apr 2026: 8,174 stars21 Apr 2026: 8,196 stars28 Apr 2026: 8,215 stars5 May 2026: 8,231 stars12 May 2026: 8,246 stars19 May 2026: 8,264 stars26 May 2026: 8,281 stars2 Jun 2026: 8,297 stars9 Jun 2026: 8,312 stars16 Jun 2026: 8,324 stars23 Jun 2026: 8,332 stars30 Jun 2026: 8,348 stars7 Jul 2026: 8,365 stars14 Jul 2026: 8,383 stars21 Jul 2026: 8,426 stars28 Jul 2026: 8,444 stars4 Aug 2026: 8,457 stars11 Aug 2026: 8,468 stars18 Aug 2026: 8,481 stars25 Aug 2026: 8,488 stars1 Sept 2026: 8,500 stars8 Sept 2026: 8,506 stars15 Sept 2026: 8,527 stars22 Sept 2026: 8,537 stars29 Sept 2026: 8,550 stars6 Oct 2026: 8,561 stars13 Oct 2026: 8,566 stars20 Oct 2026: 8,573 stars

8,074 on 31 Mar 20268,573 on 20 Oct 2026

From GitHub's daily star counts.

Checked on GitHub.

Overview

mcp-agent is a Python library that connects LLMs to MCP servers and manages server connection lifecycles. It implements the patterns from Anthropic's Building Effective Agents (parallel, orchestrator, router, evaluator-optimizer) as composable workflows. Execution runs on asyncio by default, or on Temporal for durable, resumable runs without API changes.

Who it is for: Python developers building MCP-based agents and workflows

Strengths

  • Implements MCP tools, resources, prompts, OAuth, sampling, elicitation and roots
  • Same decorators run on asyncio or Temporal for durable execution
  • Agents can be exposed as MCP servers with a FastMCP-compatible API
  • CLI scaffolds projects via uvx mcp-agent init

Weaknesses

  • Last release was 2025-05-09, well behind recent commits
  • Durable mode requires running a Temporal backend
  • Managed cloud deploy (mcp-c) is labeled beta
  • No Docker or compose files detected in the repo

What it needs

  • Python, OpenAI, Anthropic, Google, Azure
  • Needs Temporal (optional, durable execution), MCP servers (e.g. uvx, npx), LLM provider API key

Also in Agent and MCP starters

See all 38
Also in Agent and MCP starters
RankProjectScore
1deepseek-harnessPlugin-based agent harness from DeepSeek with a local Web UI256.5k starsMIT70 out of 100
2mcp-typescript-templateTypeScript starter for remote MCP servers over HTTP with Express and Effect58 starsMIT63 out of 100
3docker-agentDocker CLI plugin that runs multi-agent teams defined in YAML4.6k starsApache-2.060 out of 100
#4mcp-useTypeScript framework for building MCP servers with React Views and an Inspector Live demo ↗ (opens in a new tab)10.8k starsMIT59 out of 100
#5computerDurable Object virtual filesystem with container, shell and JavaScript runtimes for agents9.7k starsMIT59 out of 100