MCP 入門：MCP サーバー・MCP クライアントを作ってみよう

IwakenLab TechBook vol.6 第 1 章の実装サンプル
Model Context Protocol (MCP) で AI がローカルファイルを操作する TODO 管理システム

!MCP Architecture

🎯 このプロジェクトで体験できること

• Claude Desktop: 自然言語でローカル TODO 管理
• MCP サーバー開発: FastMCP を使った独自ツール作成
• カスタムクライアント: Claude API との直接連携

🏗️ 構成

mcp-introduction/
├── mcp-todo-server/    # MCPサーバー (Resources + Tools)
└── mcp-client/         # Claude API連携クライアント

⚡ クイックスタート

必要環境

• Python 3.10+ / Node.js / Claude Desktop

1. uv のインストール

PowerShell を管理者権限で実行:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

新しいターミナルで確認: uv --version

2. プロジェクトセットアップ

git clone [repository-url]
cd mcp-introduction

# 両プロジェクトを初期化
cd mcp-todo-server && uv init && uv add fastmcp
cd ../mcp-client && uv init && uv add anthropic mcp python-dotenv

# APIキー設定
cp .env.example .env  # .envにANTHROPIC_API_KEYを設定

2 つの体験方法

🔹 Claude Desktop (推奨)

• 設定ファイル更新で即体験可能
• 詳細: mcp-todo-server/README.md

🔹 カスタムクライアント

cd mcp-client
uv run python client.py todo-manager

📖 技術書・関連リンク

• 技術書展 18 - IwakenLab TechBook vol.6
• MCP 公式ドキュメント
• FastMCP