MCP Template

This is a template project for building a Model Context Protocol (MCP) server, providing a basic service framework, tool definition examples, and error - handling mechanisms, and supporting integration with AI systems such as Claude.

Developer tools Artificial intelligence chatbots #AI Integration #Protocol Service #Development Template Remote .JavaScript

rating : 2 points

downloads : 8.3K

update time : 2025-04-28

Open Site

What is an MCP Server?

An MCP server is a web service that allows AI systems (such as Claude) to interact with external data sources and tools via the HTTP or HTTPS protocol. It follows the Model Context Protocol (MCP), a protocol developed by Anthropic to enhance the capabilities of AI models.

How to Use the MCP Server?

To use the MCP server template, you need basic knowledge of Node.js and JavaScript/TypeScript programming. The template provides a starting point that you can customize and extend according to your specific needs. The main steps include installing dependencies, configuring environment variables (such as API keys), implementing specific business logic, and starting and testing the service.

Use Cases

The MCP server is suitable for various scenarios, such as connecting to third - party APIs (e.g., weather forecasts, social media, databases, etc.) or integrating custom tools. It is particularly suitable for developers who want to extend the capabilities of Claude, enabling them to handle more complex tasks through AI.

Install Node.js and npm

Ensure that your system has the latest version of Node.js and npm (Node Package Manager) installed.

Clone the Repository and Enter the Directory

Use Git to clone the MCP server template repository and navigate to the project directory.

Install Dependencies

Run the `npm install` command to install the required dependency packages, including common libraries such as Express and Axios.

Configure Environment Variables

Create a `.env` file and add the necessary environment variables, such as API keys and port numbers.

Implement Business Logic

According to specific needs, write routes and logic functions for handling HTTP requests, such as querying databases or calling external APIs.

Start the Service

Run the `npm start` command to start the MCP server and test its functionality in a browser or Postman.

🚀 MCP Server Template

A clean template for building a Model Context Protocol (MCP) server.

🚀 Quick Start

The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI systems like Claude to interact seamlessly with various data sources and tools, establishing a secure two-way connection.

This template provides a starting point for building your own MCP server, which can be used with Claude Desktop, Cursor, or any other MCP client.

✨ Features

This template includes:

A basic server structure with the MCP SDK
Example tool definitions with annotated placeholders
Error handling settings
Environment variable configuration via dotenv

📦 Installation

Prerequisites 🔧

Before you start, ensure you have the following:

API keys for the services you're using (if applicable)
Node.js (v20 or higher)
An MCP client such as Claude Desktop or Cursor

Steps

Clone this template repository:

git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

Install dependencies:

npm install

Build the project:

npm run build

📚 Documentation

Customization Guide 🔧

To customize this template for your own MCP server:

Update package.json to set your server name and details.
Modify src/index.ts to:
- Define your API response interface.
- Add actual tools and their schemas.
- Implement tool functionality.
- Update formatting logic.

Key File Modifications

src/index.ts: The main server implementation file.
package.json: Package metadata and dependencies.
.env: Create this file to store your API keys (make sure to add it to .gitignore).

Running Your Server 🖥️

You can run your server directly:

npm run build
node build/index.js

Integrating with MCP Clients

Configuring the Claude Desktop App

For macOS:

# Create the configuration file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add your server configuration:

{
  "mcpServers": {
    "your-server-name": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "YOUR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuring Cursor

Open Cursor settings.
Navigate to Features > MCP Server.
Click the "+ Add New MCP Server" button.
Fill in the following information:
- Name: Enter a nickname for your server (e.g., "your-server-name").
- Type: Select "Command" as the type.
- Command: Enter the command to run your server:
```
env YOUR_API_KEY=your-api-key node /path/to/your/build/index.js
```

🔧 Technical Details

Server Setup: This template creates a basic MCP server with stdio transport.
Tool Definitions: Example tool schemas with annotated placeholders.
Error Handling: Basic error handling settings and console logging.
Request Handling: A request handling template using a switch/case structure.

🤝 Contribution

Feel free to use this template as a starting point for your own MCP server. If you improve the template, consider contributing back via a pull request!