MCP Framework

If you're looking for a simple and efficient way to build services that comply with the Claude MCP protocol, then the MCP-Framework is definitely a tool worth checking out. This TypeScript framework is specifically designed for the Claude MCP protocol and allows you to set up a complete MCP server in just 5 minutes, streamlining the development process and enhancing efficiency.

In this article, we'll guide you through the steps to quickly create an MCP server using the MCP-Framework, enhancing your development experience and facilitating easy integration with Claude Desktop. Let's explore how this framework simplifies and speeds up the development of MCP servers!

What is MCP-Framework?

![[06f81f3e29a3b762217b352ef15d6d37_MD5.jpeg]]

MCP-Framework is an open-source development framework built with TypeScript, specifically designed for the Claude MCP protocol. It provides a modern development environment that supports automatic loading of tools, resources, and prompts, allowing developers to quickly create servers that comply with MCP protocol requirements.

The framework's core philosophy is quite simple: it enables efficient creation of MCP servers while avoiding tedious manual configurations, thus saving you a significant amount of time. With MCP-Framework, developers can concentrate on business logic without getting bogged down by the underlying technical details of the framework.

Why Choose MCP-Framework?

Fast Development
With MCP-Framework, you can set up a fully functional MCP server in under 5 minutes, allowing you to start your development work quickly. The framework includes powerful CLI tools that make it easy to create projects, add features, and more.
Automatic Loading
MCP-Framework automatically handles the loading and management of tools, resources, and prompts within your project, minimizing the hassle of manual configuration and directory management. This feature helps you quickly locate the components you need.
Type Safety and Input Validation
Using TypeScript and Zod, the framework offers robust type safety protection, ensuring that input data meets required standards. This helps to minimize errors and unnecessary debugging.
User-Friendly CLI Tools
The built-in command line tools make it easy to generate projects, add new features, or modules with just a few simple commands.

How to Set Up a Claude MCP Server Using MCP-Framework?

Let’s take it step-by-step to see how to use MCP-Framework to set up a complete Claude MCP server in just 5 minutes. Just follow these straightforward steps to easily complete your server setup.

Step 1: Install MCP-Framework Globally

First, you’ll need to install MCP-Framework globally. Run the following command in your terminal:

npm install -g mcp-framework

Step 2: Create an MCP Server Project

After installation, use the CLI tool to create a new MCP server project. Enter this command in the terminal:

mcp create my-mcp-server

This automatically generates a new project called my-mcp-server along with the necessary directory structure.

Step 3: Navigate to the Project Directory

Once the project is created, move into the project directory:

cd my-mcp-server

Step 4: Build the Project

Next, build the project by running:

npm run build

This command generates the executable files needed for the project.

Step 5: Start Your Server

Now, it’s time to start your MCP server! Simply enter the following command:

node dist/index.js

Congratulations, your MCP server is now ready! You can start sending requests to your MCP server from an MCP client (like Claude Desktop).

Key Features of MCP-Framework

Automatic Loading of Tools and Resources
MCP-Framework takes care of automatically loading tools, prompts, and resources from the src/tools, src/prompts, and src/resources directories. This means you don't have to configure the project structure manually; the framework manages it all, saving you a lot of time.
Robust CLI Support
With the integrated CLI tool, you can quickly add tools, prompts, and resources. Just a single command will allow you to create a new tool easily. For example:
```
mcp add tool weather
```
This command will generate a WeatherTool.ts file automatically, which you can modify to fit your needs.

Type Safety and Validation
MCP-Framework utilizes the Zod library for strong type validation of input data. This ensures that each request and response adheres to the expected formats, reducing possible debugging and errors. For instance, when creating a weather query tool, you can set the type and validation rules for the request data:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface WeatherInput {
  city: string;
}

class WeatherTool extends MCPTool<WeatherInput> {
  name = "weather";
  description = "Get weather information for a city";

  schema = {
    city: {
      type: z.string(),
      description: "City name to get weather for",
    },
  };

  async execute({ city }: WeatherInput) {
    return {
      city,
      temperature: 22,
      condition: "Sunny",
      humidity: 45,
    };
  }
}

export default WeatherTool;

Integration with Claude Desktop
Once set up, your MCP server can be easily integrated with Claude Desktop. A few simple configurations allow Claude Desktop to invoke your MCP tools for quick functional testing. For instance, adding MCP server details into Claude's configuration file might look like this:
```
{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/weather-mcp-server/dist/index.js"]
    }
  }
}
```
Then, within Claude Desktop, you can directly call the weather tool, for example:

“Could you check the weather in London using the weather tool?”

Conclusion: MCP-Framework Simplifies and Streamlines MCP Server Development

With MCP-Framework, setting up a server compliant with the Claude MCP protocol takes only 5 minutes, enabling rapid development of compliant tools, resources, and prompts. With its automatic loading features, type safety, and powerful CLI tools, developers can focus on business logic without the hassle of configuration and architecture.

If you’re a developer working with the Claude MCP protocol or seeking a more efficient way to develop MCP servers, MCP-Framework is a tool you should definitely try.

Start your MSP service journey with MCP-Framework today! 🚀

Related Links: