Visualization of the MCP-agent codebase

[ivanmilevtues]

Hey all,

I have generated a high-level diagram representing the mcp-agent codebase. You can check it here: https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/mcp-agent-discussion/on_boarding.md

Me, toghether with a friend are trying to build something which can help people get up-to-speed with new codebases. We believe that visuals are the way to go and that is why we leverage static analysis and LLMs to generate high-level diagrams like the one I have linked here.

I would love to hear your opinion on a diagram first documentation and if you think it is a good fit for on-boarding!

Any feedback is more than welcome! And if you like the diagram I'd be more than happy to open a PR with it :)

Full disclosure: we're trying to turn this into a startup, but we're still in a very early stage and figuring out what will actually be useful for people.

[saqadri]

@ivanmilevtues this is an excellent start! I like it and would love for it to be added to a DESIGN.md or something like that in the repo. Some high level feedback, if possible to address:

• Rename "LLM & Embedding Integration" to "Augmented LLM patterns" or something like that
• Rename "Application Server" to "MCP Agent Server"
• Missing MCP specific core classes (or I missed it): MCPServerRegistry, MCPAggregator, MCPConnectionManager, gen_client. I think this is crucial because likely the key question people have is about how mcp-agent connects to MCP.

Overall I think this is super useful as a way of navigating and understanding the codebase.

My product feedback for you is to also consider having this as a vscode extension so I could generate these visualizations as a developer in a codebase (and for it to update with refactorings, etc.)

[ivanmilevtues]

Thank you for the feedback, I am super happy that you find what we do valuable! I will take a look into the generations later. I will try to fix-up the references you've mentioned and more importantly check why are they not included!

Futher on the VSCode extension we are already working on it here is a preview of the dev build we have:

[ivanmilevtues]

It is me again @saqadri.

We've been at work the last week. We now have a new updated version of the generation, and I have regenerated for the mcp-agent project: https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/mcp-agent/on_boarding.md

Now we don't expand every component, but only the ones that we think are complicated and need expansion. I would love to hear what do you think on the new version. In the new version the MCPServerRegistry, MCPAggregator, MCPConnectionManager
and gen_client are present (In the MCP Communication component and the MCPAggregator then).

Further I updated the last one according to the names you wanted to be changed:
https://github.com/CodeBoarding/GeneratedOnBoardings/blob/main/mcp-agent-discussion/on_boarding.md

I would love to hear what do you think, also I am super keen on doing the PR and the diagram.md file you suggested <3.

We now have initial version of our GithubAction as well which will keep the diagrams up-to-date.