Skip to content

Commit 78d83b8

Browse files
committed
Add overview section to readme
1 parent e19b4e6 commit 78d83b8

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

README.md

+12-9
Original file line numberDiff line numberDiff line change
@@ -21,20 +21,23 @@
2121
<a href="https://github.com/lastmile-ai/mcp-agent/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/mcp-agent" /></a>
2222
</p>
2323

24-
# mcp-agent
24+
## Overview
2525

26-
**A light, extensible agent framework built on [Model Context Protocol](https://modelcontextprotocol.io/introduction) that enables orchestration of AI workflows and tools in a straightforward, code-first manner.**
26+
**`mcp-agent`** is a simple, composable framework to build agents using [Model Context Protocol](https://modelcontextprotocol.io/introduction).
2727

28-
This framework supports:
28+
Anthropic announced 2 foundational updates for AI application developers:
2929

30-
- **MCP** (Model Context Protocol) servers for standardized tool interfaces, prompts, memory, etc.
31-
- An **Agent** abstraction that can seamlessly attach to multiple MCP servers, handle human input, signals, or additional specialized tasks.
32-
- Common agent patterns, such as Swarm (by OpenAI), and Evaluator-Optimizer, Orchestrator, Router, and more from [Anthropic’s _Building Effective Agents_ blog](https://www.anthropic.com/research/building-effective-agents), adapted for code-based control flow instead of rigid "graph-based" structures.
33-
- **Durable Execution** with pluggable backends (e.g., [Temporal](https://temporal.io)) for advanced pause/resume, parallelization, and human-in-the-loop signals.
30+
1. [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) - a standardized interface to let any software be accessible to AI assistants via MCP servers.
31+
2. [Building Effective Agents](https://www.anthropic.com/research/building-effective-agents) - a seminal writeup on simple, composable patterns for building production-ready AI agents.
3432

35-
> **Why code-based control flow?** In many agent frameworks, you must model nodes/edges, which adds an unnecessary layer of complexity. For conditionals, you have to craft subgraphs, or for loops, you must create cyclical edges. In **mcp-agent**, you just write regular Python control flow (loops, if/else conditionals) and let the executor handle concurrency, resiliency and orchestration.
33+
`mcp-agent` puts these two foundational pieces into an AI application framework:
3634

37-
---
35+
1. It handles the pesky business of managing the lifecycle of MCP server connections so you don't have to.
36+
2. It implements every pattern described in Building Effective Agents, and does so in a _composable_ way, allowing you to chain these patterns together.
37+
3. **Bonus**: It implements [OpenAI's Swarm](https://github.com/openai/swarm) pattern for multi-agent orchestration, but in a model-agnostic way.
38+
39+
Altogether, this is the simplest and easiest way to build robust agent applications. Much like MCP, this project is in early development.
40+
We welcome all kinds of [contributions](/CONTRIBUTING.md), feedback and your help in growing this new standard.
3841

3942
## Get Started
4043

0 commit comments

Comments
 (0)