mcp-agent

Stale
GitHub Python Apache-2.0

Description

mcp-agent is LastMile AI's toolkit for building agents around Model Context Protocol integrations, making it easier to connect MCP tools into multi-step workflows.

Key Features

  • Full MCP implementation with automatic lifecycle management of MCP server connections
  • Composable agent patterns from Anthropic's Building Effective Agents guide (map-reduce, orchestrator, evaluator-optimizer, router, etc.)
  • Durable execution via Temporal runtime — pause, resume, and recover workflows without API changes
  • Create MCP servers with FastMCP-compatible API, expose agents as MCP services
  • CLI scaffolding with `uvx mcp-agent init` and one-command cloud deployment
  • Complete support for Tools, Resources, Prompts, OAuth, Sampling, Elicitation, and Roots

Use Cases

💡 Building multi-step agent workflows that connect multiple MCP tools
💡 Integrating MCP tools into production-grade agent applications
💡 Creating durable agent tasks that can be paused, resumed, and recovered
💡 Building MCP servers usable from ChatGPT and other clients
💡 Rapidly prototyping Anthropic's effective agent patterns

Strengths & Limitations

Strengths

  • High community interest (8.5k stars)
  • Permissive open-source license (Apache-2.0)

⚠️ Limitations

  • No updates in over 7 months

Categories

Quick Start

Install: pip install mcp-agent or scaffold with `uvx mcp-agent init`. Configure your LLM API key in mcp_agent.secrets.yaml. Define an Agent with server_names and instruction, attach an AugmentedLLM to interact. Deploy with `uvx mcp-agent deploy` to cloud.

Related Projects

Awesome Claude Skills

74.3k · Python
Active A

A curated list of awesome Claude Skills, resources and tools for customizing Claude AI workflows.

mcptoolspython +1
  • · 1000+ production-ready skills - Covering 9 categories including document processing, dev tools, data analysis, marketing, and writing
  • · Cross-agent compatible - Works with Claude Code, Claude.ai, OpenAI Codex, Cursor, Gemini CLI, Windsurf and more
  • · Progressive loading architecture - Each skill loads only name and description (~100 tokens), full content on demand, hundreds coexist

Awesome LLM Skills

1.7k · Python
Normal C

A curated list of awesome LLM and AI Agent Skills, resources and tools for customising AI Agent workflows. Works with Claude Code, Codex, Gemini CLI and custom agents.

agenttoolsmcp +2
  • · Curated collection of LLM skills for Claude Code, Codex, Gemini CLI, and more
  • · Covers document processing (docx, pdf, pptx, xlsx), development tools, and research workflows
  • · Cross-platform compatibility with Anthropic, OpenAI, Google, and Alibaba AI tools

Blender MCP

26.7k · Python
Active A+

MCP server for Blender that enables AI agents to directly control the 3D modeling software for natural language-driven scene creation, model manipulation, and rendering automation.

mcptoolsagent +1
  • · Bidirectional communication — Blender addon creates socket server, MCP Server bridges AI and Blender
  • · 3D object manipulation — create, modify, delete 3D objects in Blender via natural language
  • · Material and rendering control — natural language application of materials, colors, lighting, render settings

Jupyter MCP Server

1.3k · Python
Active A

MCP server for Jupyter that enables AI agents to interact with Jupyter kernels, execute code, and manage notebooks.

pythonmcptools +2
  • · Real-time notebook control with instant visibility into code changes and execution results
  • · Smart execution feedback — auto-adjusts on cell failures with multimodal output support (images, plots, text)
  • · Complete cell operation toolkit: read, insert, delete, move cells with code and Markdown support