Sponsored by Deepsite.site

🧳 MCP Travel Desk — A Minimal MCP Client & Server Demo

Created By
ChaitanyaK777 months ago
This project demonstrates how to build a minimal MCP server using the `mcp` Python SDK and connect it to Claude Desktop as a client. It simulates a simple Travel Desk system with tools to submit, view, and track employee travel requests — all accessible directly from Claude's interface.
Content

🧳 MCP Travel Desk — A Minimal MCP Client & Server Demo

This is a simple demonstration of building an MCP server and using Claude Desktop as a client. It simply shows a Travel Desk system to handle employee travel requests, approvals, and history tracking — all accessible directly from Claude.


🚀 Setup Instructions

1. Install Claude Desktop

Download and install Claude Desktop from Anthropic. This acts as your MCP client.


2. Install MCP Python SDK

pip install mcp

3. Install uv (Python Package Manager)

pip install uv

On macOS, if this fails:

brew install uv

4. Initialize MCP Server

uv init

5. Create main.py

append the main.py code in the repo

6. Install the Server into Claude

uv run mcp install main.py

This will:

Create a virtual environment (.venv) Add your server to Claude config Output logs like:

Added server 'TravelDesk' to Claude config
Successfully installed TravelDesk in Claude app

7. macOS Troubleshooting

If the server doesn't start in Claude: Run:

brew install uv

Restart Claude Desktop Go to Claude → Developer Settings and ensure the server is Running

8. Use Claude as MCP Client

Claude reads the MCP config from .mcp/claude.json.

9. Tools Appear in Claude UI

Once installed, the following tools will be available inside Claude:

submit_travel_request get_travel_history approved_trips_count greeting://{name}

10. Ask Queries via Claude

Try asking: Submit a travel request for E001 to Paris from 2025-01-01 to 2025-01-05 How many approved trips does E002 have? Get travel history for E001 greeting://Chaitanya

Claude UI Screenshot

Recommend Servers
TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.
MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.
Amap Maps高德地图官方 MCP Server
Context7Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors
Howtocook Mcp基于Anduin2017 / HowToCook (程序员在家做饭指南)的mcp server,帮你推荐菜谱、规划膳食,解决“今天吃什么“的世纪难题; Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"
Playwright McpPlaywright MCP server
ChatWiseThe second fastest AI chatbot™
MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs
TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.
EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.
Tavily Mcp
WindsurfThe new purpose-built IDE to harness magic
DeepChatYour AI Partner on Desktop
CursorThe AI Code Editor
Baidu Map百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Serper MCP ServerA Serper MCP Server
Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code
BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.