mcpField
šŸ§³
šŸ§³ MCP Travel Desk ā€” A Minimal MCP Client & Server Demo

šŸ§³ MCP Travel Desk ā€” A Minimal MCP Client & Server Demo

Local
github.com/ChaitanyaK77Media & Design1Updated 76w ago
Repository

About šŸ§³ MCP Travel Desk ā€” A Minimal MCP Client & Server Demo

A minimal Python MCP demo that models an employee Travel Desk for submitting requests, checking approvals, and reviewing travel history. It is intended for developers exploring MCP server construction and Claude Desktop client use.

Key features

  1. 01Submit employee travel requests
  2. 02Retrieve travel history
  3. 03Count approved trips
  4. 04Provide a greeting resource

Use cases

  1. 01Submit an employee trip request through Claude
  2. 02Check an employeeā€™s approved-trip count
  3. 03Review an employeeā€™s travel history

MCP support

Implements an MCP server with the Python SDK and connects it to Claude Desktop as the client. It exposes travel-request tools, history and approval queries, and a greeting resource.

#workflow#ai#generative-ai#agentic-ai#mcp-server

Configuration

Local server config is the same for every client. Copy it into your clientā€™s MCP config file.

No install method listed yet

We havenā€™t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Travel Desk ā€” A Minimal MCP Client & Server Demo

This is a simple repository that shows the process of building an MCP server and using Claude Desktop as a client. I have shown here a simple Travel Desk system to handle employee travel requests, approvals, and history tracking ā€” all accessible directly from Claude. One can modify the contents of this repo to develop specific MCP use cases.

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.