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

MCP Travel Desk — 最小構成の MCP クライアント＆サーバーのデモ

このシンプルなリポジトリでは、MCP サーバーの構築手順と、Claude Desktop をクライアントとして使用する方法を紹介します。ここでは、従業員の出張申請、承認、履歴の追跡を処理するシンプルな Travel Desk システムを紹介しています。これらはすべて Claude から直接利用できます。このリポジトリの内容を変更して、特定の MCP ユースケースを開発できます。

---

セットアップ手順

1. Claude Desktop をインストールする

Anthropic から Claude Desktop をダウンロードしてインストールします。これは MCP クライアントとして機能します。

---

2. MCP Python SDK をインストールする

pip install mcp

3. uv（Python パッケージマネージャー）をインストールする

pip install uv

macOS で失敗する場合：

brew install uv

4. MCP サーバーを初期化する

uv init

5. main.py を作成する

リポジトリに main.py のコードを追加します

6. サーバーを Claude にインストールする

uv run mcp install main.py

これにより、次の処理が行われます。

仮想環境（.venv）を作成する サーバーを Claude の設定に追加する 次のようなログを出力する：

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

7. macOS のトラブルシューティング

Claude でサーバーが起動しない場合： 次を実行します：

brew install uv

Claude Desktop を再起動します Claude → Developer Settings に移動し、サーバーが実行中であることを確認します

8. Claude を MCP クライアントとして使用する

Claude は .mcp/claude.json から MCP 設定を読み込みます。

9. ツールが Claude の UI に表示される

インストールが完了すると、以下のツールが Claude 内で利用できるようになります。

submit_travel_request get_travel_history approved_trips_count greeting://{name}

10. Claude に質問する

次のように質問してみてください。 E001 の 2025-01-01 から 2025-01-05 までのパリへの出張を申請してください E002 の承認済み出張は何件ありますか？ E001 の出張履歴を取得してください greeting://Chaitanya