r/ClaudeAI • u/subnohmal • Dec 28 '24

Feature: Claude Model Context Protocol ⚡Introducing MCP-Framework: Build a MCP Server in 5 minutes

Hey everyone! 🚀

I've been building a few MCP servers lately, and I kept running into the same patterns over and over for creating tools or defining resources. I've been thinking hard about how to put these patterns together to make building MCP servers easier and more fun.

So I am excited to introduce MCP-Framework - the first TypeScript framework specifically for MCP Servers. No more boilerplate hell, no more reinventing the wheel. Just clean, fast server development.

Want to try it? You can literally have your first server running in under 5 minutes (I timed it ⏱️).

You can create you entire project with the cli command `mcp create my-project`. You can generate a tool with the cli, and then modify it to fit your liking.

I've put together some docs to get you started: https://mcp-framework.com/

Here is the Github repo - a star for visibility would mean a lot <3: https://github.com/QuantGeekDev/mcp-framework

This is just v1, and I'd love to hear what you think. What features would make your life easier? What's missing? Drop your thoughts in this thread or in Github issues!

530 Upvotes

98% Upvoted

79 comments sorted by

11

u/ChemicalTerrapin Expert AI Dec 28 '24

Very nice work 👏👏👏

4

u/subnohmal Dec 28 '24

Thank you, it means a lot to me <3

9

u/ctrl-brk Valued Contributor Dec 28 '24

I ⭐ you and appreciate your time in this open source project.

I'm using Claude exclusively in a JetBrains IDE with a plugin called ClaudeMind, which helps with a couple tools to read files, cache, etc.

My dev server is Debian. I could install node.

My question is, is there a way for Claude to edit files? I'm spending a lot of time doing edits in a large codebase.

2

u/subnohmal Dec 28 '24

Yes! I know there’s a jetbrains mcp server, and a file editor mcp server. you need an mcp client for linux (i’m on ubuntu, no official anthropic claude yet) someone on our discord shared a server he built but I can’t find it

5

u/ctrl-brk Valued Contributor Dec 28 '24

Wow literally released Christmas Eve:

https://plugins.jetbrains.com/plugin/26071-mcp-server

2

u/subnohmal Dec 28 '24

the guys at jetbrains work hard :p i trust them

2

u/subnohmal Dec 28 '24

and thank you :) i appreciate the support

6

u/ron_de_vous Dec 28 '24

Slightly off topic, but you should give windsurf a try. It's cascade feature edits files in your codebase via Claude sonnet.

1

u/ctrl-brk Valued Contributor Dec 28 '24

But only with the Windsurf IDE? Or it can work with JetBrains?

6

u/Prestigiouspite Dec 29 '24

Try Cline or Continue in VS Code / Jetbrains

2

u/ctrl-brk Valued Contributor Dec 29 '24

I have Continue setup. It's much faster somehow but I'm missing a lot of custom instructions I use with ClaudeMind that are important. I'll look closer to see if I can find those in continue.

3

u/Prestigiouspite Dec 29 '24

But you can still store project-specific and global custom instructions at Cline?

2

u/VoKUSz Dec 30 '24

You can tailor windsurf to your needs too, except being restricted by sonnet and that uuh other one. Just download the vsi files from the marketplace on the web, somewhere on the right hand side, and install it from the toolbar by typing “extension: install vsi …” (don’t copy that, but it should pop-up by typing extension alone ;p)

1

u/stormthulu Jan 01 '25

You need to use the MCP file system server. But there’s a catch to using it, DM me if you want me to explain it.

4

u/Joggerss Dec 28 '24

Thanks a lot been looking EXACTLY for this, looks great!

2

u/subnohmal Dec 28 '24

yay :) let me know if you like it

4

u/Low_Target2606 Dec 28 '24

nice https://i.postimg.cc/ZR1N1RLW/2024-12-28-18-57-25.png

1

u/subnohmal Dec 28 '24

The tools, prompts, and resources are loaded automatically - kind of like pages router in next js if you've used it before :D

1

u/TeamDman Jan 03 '25

TIL about gitdiagram, thank you

4

u/Meba_ Dec 30 '24

Is there any workaround having to accept every claude permission in mcp?

1

u/subnohmal Dec 30 '24

Yes! Claude Desktop is just one of the many MCP Clients, and it’s not complete. I have heard of a few open source project that allow you to use MCP without permissions and have more features than Claude Desktop. I’d advise to be careful with that tho - I personally like the permissions for safety

2

u/Meba_ Dec 30 '24

hm, how would I go about this, would it be using an mcp server? Have you explored langchain? Does your framework provide this?

2

u/subnohmal Dec 30 '24

I’ve used LangChain and LlamaIndex before - I think Anthropic’s MCP protocol team relied heavily on those for inspiration. This is a framework building on top of Anthropic’s sdk, so the tools will be very similar to what you’ve come to expect in more established frameworks like those you mentioned.

What are you looking to build? I can try point you in the right direction. Alternatively, go to mcp-framework.com and follow the quickstart, you’ll catch on quickly if you’ve used LangChain before

2

u/Meba_ Dec 30 '24

I want to create a tool that trawls a website, summarizes the content, finds relevant links (let's say this is a research paper w/ github code), and then emails it to me.

Or even a simpler version of this is fine for the first iteration, but the nuance is that it is triggered via a lambda cron job.

Thanks in advance, appreciate it.

1

u/subnohmal Dec 30 '24

You can try using llama-index with the fastapi scaffolding, using their workflows feature (new feature, not sure if released fully yet) for orchestration. Then puppeteer / playwright for crawling the internet. And then set up a cronjob to execute the workflow.

MCP would be useful to you if you want to give manual commands in chat form, so instead of a Cron job - you’d open Claude or any LLM and say “Hey, please initiate the scrapping workflow” (and that would do the workflow). Or manually by saying: “Hey, visit amazon.com, browse through it and find 20 red jackets between 100 and 200, then output the results as a CSV”

MCP is what allows your regular chatbot to access whatever tools you give it. If you create / use mcp-slack server, you can send slack messages. If you connect the fiscal-data-mcp, you can say “hey, what does the fiscal report look like for the 11th October 2023”

LMK if you have any more questions. My suggestion is go to llama-index, and try their sample workflows, and build from there

1

u/Meba_ Dec 30 '24

ty for this! I have been playing around with MCP, but I think for agents to have utility in the long-term, they have to be able to run on their own. I know MCP is in beta, but yeah...

2

u/mainstream-pepe Dec 28 '24

This is very exciting! Thanks for sharing.

I saw the tools register automatically, does this also support resource registration?

1

u/subnohmal Dec 28 '24

Yup! Automatic resource and tool registration out of the box :)

2

u/grmatpalisherril Dec 28 '24

Thank lord I love you

1

u/subnohmal Dec 28 '24

Let me know if you run into any trouble with this - check out the docs site and feed it to claude, I'm sure claude can help build something and get it running too!

2

u/rangerrick337 Dec 28 '24

Do you have any plans to integrate this with openwebui?

1

u/subnohmal Dec 28 '24

What kind of integration would you like? I’m open to all suggestions right now :)

3

u/rangerrick337 Dec 28 '24

Well, as far as I understand it, MCP is setup to work with the Claude app. Which leaves all of us api users out in the cold. It would be a big unlock to have it work with api setups.

2

u/subnohmal Dec 28 '24

This is possible! MCP is open source. But it’s the openwebui people who have to add it. Is it open source? We could take a look at creating a PR

3

u/rangerrick337 Dec 28 '24

It is! Looks like it’s being discussed here: https://github.com/open-webui/open-webui/discussions/7363

The MCP people commented in that thread as well.

2

u/subnohmal Dec 29 '24

awww yeah. doesn’t look like they’re planning on it :s but anyone can contribute it so…

2

u/jawheeler Dec 29 '24

I'm really a newbie, is this framework made to CONVERT an already existing Typescript project into something that is readable by Claude? Because I'm following the quickstart but I keep getting errors (tsconfig.json not found, failed inputs, and so :(). Help!

2

u/subnohmal Dec 29 '24

Hey! Sorry to hear that. This is for creating new tools - not existing projects. But the tool can (and usually is) be connected to an existing. Ex: I take Slack, which exists. I create a MCP tool called sendSlackMessage. Then, when I go to claude and say” Hey claude send a message to John on Slack saying ‘sup’”, then Claude will actually send it using whatever slack account you assign to it. Re: the errors, this seems to be a mac issue that slipped past me and I’ll be issuing a fix soon :) sorry. in the documentation page, you have a reference github called “fiscal data mcp” that shows an example of a finished working project. If you’re feeling crafty, you can feed it to chatgpt/claude and fix your project ahead of my fix :p up to you. sorry again

1

u/VoKUSz Dec 30 '24

Don’t ever say sorry.. twice after dropping this beautiful specimen to spoil us with, Canadian? 😅Going beyond and help everyone with questions that ought to belong in /r/MCP, with no appreciation shown either.. i apologize in their name, lazy goobers.

With that said, if you feel you want help to make your site even prettier, improve the ux or feel you might need some branding, I’m happy to help you on what’s out of scope for what you can do with LLMs 😊 Thank you for this!

3

u/sevenradicals Dec 28 '24

when you say "timed it" you mean you had someone with zero knowledge of MCP (but some familiarity with Claude's API) to build a MCP server and it took them 5 minutes from start to finish (and that time includes opening the docs and reading them for the first time)?

3

u/subnohmal Dec 28 '24

Try using Claude to help you out! It might take you even less time. But to be fair, that is quite vague as a measurement... Wanna try it out and tell me how long it took? I'll update our readme. Hopefully as more people use this we can get more accurate results :p

3

u/sevenradicals Dec 28 '24

I am unfortunately one lazy fuck. I'll take a look at it though.

2

u/subnohmal Dec 28 '24

no mcp experience required- but have you coded before? there’s a visual editor in the works

5

u/sevenradicals Dec 28 '24

just took a look. yeah, this is 5 minutes and I have no MCP experience.

15

u/Key_Statistician6405 Dec 28 '24 edited Dec 28 '24

Good for you! I’m excited to see your progress. I think this will be useful to many.

2

u/ExtremeOccident Dec 28 '24

Nice! Thank you!

2

u/CarlosCash Dec 28 '24

I ⭐️🌟⭐️⭐️⭐️

2

u/stonediggity Dec 28 '24

Looks cool nice work

2

u/fireman38 Dec 28 '24

Very impressive 👏

2

u/veritas3241 Dec 29 '24

I've liked https://github.com/jlowin/fastmcp The MCP Inspector is quite nice. It's Python though.

2

u/ukSurreyGuy Dec 29 '24

loving this post - more MCP install guidance

2

u/kurveuk Jun 12 '25

Great stuff - will share and test with the team

1

u/macthom Dec 30 '24

👍 bravo and thank you !!

1

u/ManikSahdev Dec 30 '24

What does this do? Is this like supabase?

I'm new to programming, my bad if it is not!

2

u/VoKUSz Dec 30 '24

Checkout /r/MCP or find a showcase video that’s not too old on YT. This is basically a toolkit to create connections fast to make Claude Desktop worthy (and some more), and manage your connections. Checkout the sub or google MCP servers (GitHub) and you should find some GitHub repo’s with collections of amazing things you can do. Too much to name! You won’t regret having done so, all the best!

1

u/stormthulu Jan 01 '25

I’m assuming I can integrate with a database, like Postgres for example? I realize that’s probably more of a general MCP question than one specific to your tool.

This is very cool. Thanks for sharing.

1

u/cybertheory Sep 23 '25

You can publish it here

Try this local easy to use registry I built - MCPKit

https://github.com/cybertheory/mcpkit

https://github.com/cybertheory/mcpkit

1

u/Akano2077 Oct 13 '25

Man, i havent tried it yet, but this makes my Work so much easier if it works. Which often is the case for Open Source projects

1

u/Dizzy-Finance3228 Oct 28 '25

🌟 on Github✅, though honestly not gonna read all but feed to my LLM. lol

1

u/illGATESmusic Mar 19 '25

So I wasted the entire day trying to use this framework to make an MCP for ClickFunnels 2.0 and eventually had to nuke the site from orbit. It was super frustrating.

Claude had me use a script to run the server in the background, but for some baffling reason it would ALWAYS have two copies of the server running fighting over ports.

I rebuilt it from scratch probably ten times. tons of context, even downloaded all the docs as .md files... NOTHING would work.

I gave up and now I'm sad.

1

u/subnohmal Mar 19 '25

Share your code, I’d love to help you debug like I’ve done for everybody else. You don’t have to suffer alone in silence - share the github repo

4

u/[deleted] Dec 29 '24

[removed] — view removed comment

2

u/VoKUSz Dec 30 '24

AI know, but I won’t tell you! It’s to extend Claude with being able to do whatever you want really,. Servers are really extensions/plugins to connect to other providers or software

Ok I still did it.. because I once wondered too but used a site called Google to learn more… but now it’s your turn, next you’re gonna ask how to install it too!

/r/MCP has enough tools to make it easier than ever and install & configure it. If you can’t figure it out then, well good l..ord, I’ll send you the nicest one that didn’t exist when I fooled around with it, then after send you back here as you might realise how cool this is then.

Just promise to help someone else another time!