概要
What is Custom MCP Server with Enhanced Tools?
Custom MCP Server with Enhanced Tools is a Model Context Protocol server that provides 5 custom tools to extend AI assistant capabilities directly in Cursor. Built on the AI Makerspace MCP framework, it includes web search (via Tavily API), dice rolling, QR code generation, unit conversion, and URL shortening. It is designed for developers who want to give their AI assistant hands-on utility and content generation abilities.
How to use Custom MCP Server with Enhanced Tools?
Clone the repository, install dependencies with uv sync, create a .env file with your TAVILY_API_KEY, then add the following MCP profile configuration in Cursor: {"mcpServers": {"mcp-server": {"command": "uv", "args": ["--directory", "/FULL/PATH/TO/YOUR/REPOSITORY", "run", "server.py"]}}}. Tools are then invoked via natural language prompts in the Cursor assistant, such as “Search for MCP protocol documentation” or “Roll 2d20k1”.
Key features of Custom MCP Server with Enhanced Tools
- Web search using Tavily API integration
- Dice roller with custom notation (e.g.,
2d20k1) - QR code generator for any text or URL
- Unit converter supporting length, weight, temperature, volume
- URL shortener supporting TinyURL and is.gd services
Use cases of Custom MCP Server with Enhanced Tools
- Search the web directly from the AI assistant in Cursor
- Generate QR codes for sharing links or text data
- Convert units (e.g., Fahrenheit to Celsius) during development
- Roll dice with advanced notation for game-related queries
- Shorten long URLs for cleaner output in conversations
FAQ from Custom MCP Server with Enhanced Tools
What tools are included?
The server includes Web Search (Tavily), Dice Roller, QR Code Generator, Unit Converter, and URL Shortener – five tools overall.
What prerequisites do I need?
Python 3.13 or higher, the UV package manager, and a valid Tavily API key are required.
How do I configure the server in Cursor?
Open the Command Palette (CMD/CTRL+SHIFT+P), select “View: Open MCP Settings”, and add the JSON configuration with "command": "uv" and the absolute path to your repository.
Do I need an API key?
Yes, a Tavily API key is required for the web search tool. Store it in a .env file as TAVILY_API_KEY.
Is there specific guidance for Windows users?
Yes, install uv and Git via winget, then open Cursor into Windows to run the server on the Windows side of your OS.
