6 ms·
Show HN: Mcp-Agent – Build effective agents with Model Context Protocol
Hey HN, I spent my xmas break building an agent framework called mcp-agent [1](https://github.com/lastmile-ai/mcp-agent https://github.com/lastmile-ai/mcp-agent) for Model Context Protocol [2]. It makes it easy to build AI apps with MCP servers, and implements every pattern from the popular Building Effective Agents blog [3] as well as OpenAI’s Swarm [4]. I’m sharing it early to get community feedback on where to take it from here, and to ask for contributions.
For those who aren’t familiar with MCP, I think of it as a standardized interface to let AI communicate with software via tool calls, resources and prompts.
mcp-agent provides a higher level interface to build apps with MCP. It handles the connection management of MCP servers so you don’t have to. It also implements the Building Effective Agents patterns:
- Augmented LLM (an LLM with access to one or more MCP servers)
- Router, Orchestrator-Worker, Evaluator-Optimizer, and more
- Swarm
The key design principles are composability and reusability – every pattern is an AugmentedLLM itself, so you can chain them into more complex workflows.
Some background: I worked on LSP [5] and language servers at Microsoft, and saw firsthand how standards and protocols can revolutionize developer workflows. Before LSP every IDE had its own esoteric ways of providing language services. LSP changed all that, and arguably made every language server better, since they can focus on improving a single implementation for all clients.
I think AI development is in a similar pre-LSP space right now. There are tons of frameworks [6], every model provider has its own way of handling messages, tool calls, streaming, etc. I really think we need a protocol to standardize these patterns.
Pretty soon every service is going to expose an MCP interface, and mcp-agent is about letting developers orchestrate these services into applications (i.e. build “MCP apps”). This can cover any use of an AI model that needs to interact with the world around it:
- RAG pipelines and Q&A chatbots
- Process automation via AI workflows/async tasks
- Multi-agent orchestration, with human in the loop
The repo contains examples [7] to build RAG agents, streamlit apps and more. There’s a lot left to build, like streaming support, server auth and tighter integration with MCP clients.
But I wanted to share early in the hopes that you can guide me:
- If you find this useful, please let me know. If it’s useful to you, I will dedicate all my time to improving it.
- I really welcome contributions. If you want to collaborate, please reach out on github to help take this forward.
I want to help standardize AI development, so developers a few years from now can look back with horror at the pre-MCP days.
[1] - https://github.com/lastmile-ai/mcp-agent https://github.com/lastmile-ai/mcp-agent
[2] - https://modelcontextprotocol.io/introduction https://modelcontextprotocol.io/introduction
[3] - https://www.anthropic.com/research/building-effective-agents https://www.anthropic.com/research/building-effective-agents
[4] - https://github.com/openai/swarm https://github.com/openai/swarm
[5] - https://microsoft.github.io/language-server-protocol/ https://microsoft.github.io/language-server-protocol/
[6] - https://xkcd.com/927/ https://xkcd.com/927/ (I understand the irony)
[7] - https://github.com/lastmile-ai/mcp-agent/tree/main/examples https://github.com/lastmile-ai/mcp-agent/tree/main/examples
- sanchitmonga22 2y agoThis is awesome!
- deleted 2y ago[deleted]
- saqadri 2y agoPlease let me know if you have any questions - I'll be monitoring the post today and would love to discuss!
- sparacha 2y agoOP - congrats on this launch! I think there are a lot of useful bits here, especially the communication abstractions for MCP and having clear recipes to implement patterns mentioned by Anthropic team is a big plus.
- shrisukhani 2y agothis is neat - congrats!
- exclipy 2y agoThis looks very nice, and obviously needed in hindsight. I would love to see a Typescript/node port of this.
- saqadri 2y agoYou know, I personally would love that too. TypeScript is my favorite language and tons of infra is built on Node now. Would you like to collaborate on building an mcp-agent.js? I think it can be done within a week or so. Let me know!