Custom MCP Server
A Next.js-based MCP server that provides basic utility tools including echo, current time retrieval, and safe mathematical calculations through HTTP and SSE transports.
What is Custom MCP Server?
Custom MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to next.js-based mcp server that provides basic utility tools including echo, current time retrieval, and safe mathematical calculations through http and sse transports.
A Next.js-based MCP server that provides basic utility tools including echo, current time retrieval, and safe mathematical calculations through HTTP and SSE transports.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Next.js-based MCP server that provides basic utility tools
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx custom-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Custom MCP Server
The Custom MCP Server is a Next.js-based server that exposes three practical utility tools — echo, get-current-time, and calculate — over both HTTP and Server-Sent Events (SSE) transports. It uses Redis (local or Upstash) for rate limiting at 100 requests per minute, making it a production-ready template for building and testing MCP integrations. Developers use it to prototype MCP tool patterns or as a reference implementation showing how to connect an AI assistant to a hosted server endpoint.
Prerequisites
- Node.js 18 or later installed
- Redis running locally (redis://localhost:6379) or an Upstash Redis account for production
- An MCP-compatible client such as Claude Desktop or Claude Code
- Git to clone the repository from https://github.com/Meerisha/custom-mcp-server
Clone the repository
Clone the custom-mcp-server repository to your local machine.
git clone https://github.com/Meerisha/custom-mcp-server
cd custom-mcp-serverInstall dependencies
Install the Node.js dependencies required by the Next.js server.
npm installConfigure Redis
Create a .env.local file with your Redis connection details. For local development use REDIS_URL; for production use the Upstash variables.
# Local development
REDIS_URL=redis://localhost:6379
# Production (Upstash)
UPSTASH_REDIS_REST_URL=https://your-instance.upstash.io
UPSTASH_REDIS_REST_TOKEN=your-token-hereRun automated setup
Use the setup script to validate the Redis configuration and prepare the server.
npm run setupStart the development server
Start the Next.js MCP server. It will listen for HTTP requests at /mcp and SSE connections at /sse.
npm run devConfigure your MCP client
Add the server to your Claude Desktop configuration file. The server runs locally so no authentication is needed.
Custom MCP Server Examples
Client configuration
Add the Custom MCP Server to Claude Desktop's claude_desktop_config.json using the HTTP transport endpoint.
{
"mcpServers": {
"custom-mcp-server": {
"command": "npx",
"args": ["custom-mcp-server"],
"env": {
"REDIS_URL": "redis://localhost:6379"
}
}
}
}Prompts to try
Once connected, test the three available tools with these prompts.
- "Echo the message 'hello world' back to me"
- "What is the current time right now?"
- "Calculate 15 multiplied by 4 plus 10"
- "What is the square root of 144?"Troubleshooting Custom MCP Server
Server fails to start with a Redis connection error
Ensure Redis is running locally with 'redis-server' before starting the dev server, or verify your UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN values are correct.
Rate limit errors (429 Too Many Requests) appear during testing
The server enforces a limit of 100 requests per minute per client. Wait 60 seconds before retrying, or adjust the rate limit settings in the server configuration.
MCP client cannot connect to the server
Confirm the Next.js server is running on port 3000 and that your client is pointing to http://localhost:3000/mcp (HTTP) or http://localhost:3000/sse (SSE). Check for firewall rules blocking local connections.
Frequently Asked Questions about Custom MCP Server
What is Custom MCP Server?
Custom MCP Server is a Model Context Protocol (MCP) server that next.js-based mcp server that provides basic utility tools including echo, current time retrieval, and safe mathematical calculations through http and sse transports. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Custom MCP Server?
Follow the installation instructions on the Custom MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Custom MCP Server?
Custom MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Custom MCP Server free to use?
Yes, Custom MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Custom MCP Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to Custom MCP Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Custom MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Custom MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.