from Hacker News

Show HN: Mcp-Agent – Build effective agents with Model Context Protocol

by saqadri on 1/29/25, 4:26 PM with 28 comments

Hey HN, I spent my xmas break building an agent framework called mcp-agent [1](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

[2] - https://modelcontextprotocol.io/introduction

[3] - https://www.anthropic.com/research/building-effective-agents

[4] - https://github.com/openai/swarm

[5] - https://microsoft.github.io/language-server-protocol/

[6] - https://xkcd.com/927/ (I understand the irony)

[7] - https://github.com/lastmile-ai/mcp-agent/tree/main/examples

  • by a1j9o94 on 1/30/25, 2:12 AM

    This is really interesting. Has anyone seen a good registry of MCP servers somewhere? What I would love to be able to do is ask for a task and have the agent figure out what servers and tools it needs to accomplish that task directly.
  • by sparacha on 1/29/25, 8:48 PM

    OP - 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.
  • by exclipy on 1/29/25, 10:57 PM

    This looks very nice, and obviously needed in hindsight.

    I would love to see a Typescript/node port of this.

  • by nurettin on 1/30/25, 4:58 AM

    What's so special about this other than poisoning straightforward python code with async/await?

    Claude message API already accepts a tools=[] parameter. All you need is a json schema of your python class and docs which you can easily generate with a few dozen lines of code.

    Then just call whatever the LLM outputs like getattr(instance, result["name"])( **result["kwargs"]) and your computer is controlled by AI congratulations.

  • by codenote on 1/31/25, 1:35 PM

    I'm considering implementing MCP into an application in the future. This information will be very helpful for that. Thank you!
  • by saqadri on 1/29/25, 8:44 PM

    Please let me know if you have any questions - I'll be monitoring the post today and would love to discuss!
  • by sanchitmonga on 2/8/25, 12:41 AM

    This is awesome!
  • by justintorre75 on 1/30/25, 1:40 AM

    MCP Agent seems super promising and the team behind it is amazing!
  • by wedn3sday on 1/29/25, 11:27 PM

    The example code reminds me how much I absolutely loath python async/await syntax.

    >>> server_names=["fetch", "filesystem"]

    This is, IMO, bad design. Where is the fetch defined? How would I find these? If it was an imported module I could easily find the definition to see what its doing, or subclass it to make my own, but instead its just some magic strings getting passed making it astronomically more difficult to understand what the heck is going on.

  • by shrisukhani on 1/29/25, 9:21 PM

    this is neat - congrats!