custom-mcp-server
Triggers remote n8n workflows via webhook, sending a prompt and returning the response.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@custom-mcp-server Show me the customer support playbook"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Custom MCP Server: Calculator & Workflow Automation
This is a custom Model Context Protocol (MCP) server built with Python using the FastMCP framework. It provides a set of calculator tools, resources for customer support, and prompts for content creation, along with integration to external n8n workflows.
Features
🛠️ Tools
Tools allow the AI model to perform actions or computations.
add(a, b): Add two numbers.subtract(a, b): Subtract two numbers.multiply(a, b): Multiply two numbers.divide(a, b): Divide two numbers (handles division by zero).trigger_n8n_workflow(prompt): Triggers a remote n8n workflow via webhook, sending a prompt and returning the response.
📚 Resources
Resources provide context and data to the AI model.
calculator://support-playbook: Reads and returns the content of the "Customer Support Playbook" (resource_exampe.md).
📝 Prompts
Prompts provide structured templates for the AI model to generate content.
webinar_blog_post: A template to convert a webinar transcript into an engaging blog post. requires:webinar_title,webinar_date,speakers,transcript.
Related MCP server: MCP Server for n8n Integration
Prerequisites
Python 3.10+ (Recommend managing with
uv)uv: A fast Python package installer and resolver.
npx: Required if you want to use the MCP Inspector for testing.
Installation & Setup
Clone or Navigate to the Project Directory
Install Dependencies Use
uvto sync the project dependencies:uv syncConfigure Environment Variables This server requires environment variables for the n8n integration.
Create a
.envfile from the example:cp .env.example .envOpen
.envand configure your settings:N8N_WEBHOOK_URL=https://your-n8n-instance.com/webhook/... N8N_HEADER_NAME=Your-Header-Name N8N_HEADER_VALUE=Your-Header-ValueNote: If
N8N_HEADER_NAMEandN8N_HEADER_VALUEare set, they will be included in the webhook request headers.
Usage
🔍 Testing with MCP Inspector
The MCP Inspector is a developer tool to test your server's tools, resources, and prompts in a web interface.
Run the follow command:
npx @modelcontextprotocol/inspector uv run server.pyThis will launch a local server (usually at http://localhost:5173) where you can interact with your MCP server.
🤖 Integration with Claude for Desktop
To use this server with the Claude desktop app:
Locate Configuration File:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Update Configuration: Add the server configuration to the
mcpServersobject. You can copy the contents of theclaude_desktop_config.jsonfile provided in this repository.{ "mcpServers": { "calculator": { "command": "uv", "args": ["--directory", "/ABSOLUTE/PATH/TO/THIS/PROJECT", "run", "server.py"] } } }Important: Replace
/ABSOLUTE/PATH/TO/THIS/PROJECTwith the actual absolute path to this directory on your machine.Restart Claude: Restart the Claude application to load the new server.
Troubleshooting
Timeout Errors: The n8n workflow trigger has a 30-second timeout. If your workflow takes longer, you may need to increase this in
server.py.Missing Environment Variables: Ensure your
.envfile is properly set up and that you are running the server from the project root where the.envfile is located.Claude Connection Issues: Check Claude's logs for connection details. Ensure the absolute path in the config file is correct.
Project Structure
server.py: Main MCP server implementation.resource_exampe.md: Source file for the support playbook resource.prompt.md: Template file for the blog post prompt..env: (Ignored by git) Local configuration for secrets.pyproject.toml: Python project and dependency definition.
Available Tools
5 toolsaddA
Add two numbers
Inputs: a (required), b (required). Returns: result
divideC
Divide two numbers
Inputs: a (required), b (required). Returns: result
multiplyA
Multiply two numbers
Inputs: a (required), b (required). Returns: result
subtractA
Subtract two numbers
Inputs: a (required), b (required). Returns: result
trigger_n8n_workflowC
Trigger an n8n workflow with a prompt
Inputs: prompt (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The four arithmetic tools have clear, distinct purposes, and the workflow trigger is unrelated, so there is no ambiguity between any of the tools.
The arithmetic tools use simple single-word verbs (add, subtract), while trigger_n8n_workflow uses a verb_noun pattern with an underscore, breaking the otherwise consistent naming convention.
Five tools is within the ideal range, and each tool is simple and focused, though the mix of calculator functions and a workflow trigger is eclectic.
The arithmetic set covers basic operations but lacks advanced ones like exponentiation or modulo, and the workflow trigger has no supporting tools, leaving gaps in both implied domains.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Public remote MCP server for Walnai AI Consulting services, pricing, calculator, FAQs, and adoption.
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.246 npm1,631MIT
- FlicenseNot gradedqualityNot gradedmaintenanceA Model Context Protocol server that enables AI agents to interact with n8n workflows and automation tools through a standardized interface, allowing execution of workflows and access to n8n functions.-
- AlicenseAqualityAmaintenanceA Model Context Protocol server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations for effective workflow automation.2947,555 npm23,286MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations, enabling them to understand and work with n8n's 525+ workflow automation nodes.32MIT