MCP From Zero: Quick Data

MCP の基礎：クイックデータ

目的：ツールを再利用可能なエージェント型ワークフロー（ADW、つまりツール付きプロンプト）へと拡張し、強力な Model Context Protocol（MCP）サーバーを構築する方法を学びます。

クイックデータ

Quick-Data は、エージェントに .json および .csv ファイルの任意のデータ分析機能を提供する MCP サーバーです。

MCP サーバーの要素、特にプロンプト > ツール > リソースを試すための具体的なユースケースとして、quick-data を使用します。

MCP サーバーの詳細については、quick-data-mcp をご覧ください。

主な問い

次の3つの主な問いを検討します。

1. ツール、リソース、プロンプトを組み合わせて使用することで、カスタム構築した MCP サーバーの価値を最大化するにはどうすればよいでしょうか？
2. MCP サーバーの構築に最適なコードベースのアーキテクチャは何でしょうか？
3. MCP サーバーをすばやく構築するために使用できるエージェント型ワークフロー（ツール付きプロンプト）を構築できるでしょうか？

MCP コンポーネントを理解する

MCP サーバーには、AI モデルにできることを拡張する3つの主要な構成要素があります。

ツール

概要：AI モデルがアクションを実行するために呼び出せる関数です。

使用場面：ドメイン固有のユースケースに基づいて、低～中程度の原子性レベルで AI に何かを実行させたい場合に使用します。

例：

@mcp.tool()
async def create_task(title: str, description: str) -> dict:
    """Create a new task."""
    # AI can call this to actually create tasks
    return {"id": "123", "title": title, "status": "created"}

リソース

概要：AI モデルが読み取り、アクセスできるデータです。

使用場面：ユーザープロファイル、設定、ステータス、その他あらゆるデータソースなどの情報を AI に読み取らせたい場合に使用します。

例：

@mcp.resource("users://{user_id}/profile")
async def get_user_profile(user_id: str) -> dict:
    """Get user profile by ID."""
    # AI can read this data to understand users
    return {"id": user_id, "name": "John", "role": "developer"}

プロンプト

概要：特定の種類の会話を始めるための、事前に用意された会話テンプレートです。

使用場面：ドメイン固有のユースケースで、一般的かつ繰り返し行うワークフローのための構造化された出発点を AI に与えたい場合に使用します。

例：

@mcp.prompt()
async def code_review(code: str) -> str:
    """Start a code review conversation."""
    # AI gets a structured template for code reviews
    return f"Review this code for security and performance:\n{code}"

クイック判断ガイド

• AI にアクションを実行させたいですか？ → ツールを使用します
• AI にデータを読み取らせたいですか？ → リソースを使用します
• 再利用可能なエージェント型ワークフロー（ADW）が必要ですか？ → プロンプトを使用します

クイックセットアップ

Quick Data MCP サーバーを使用するには：

1. MCP サーバーのディレクトリに移動します：

   cd quick-data-mcp/
   

2. MCP クライアント用に設定します：

   # Copy the sample configuration
   cp .mcp.json.sample .mcp.json
   
   # Edit .mcp.json and update the --directory path to your absolute path
   # Example: "/Users/yourusername/path/to/quick-data-mcp"
   

3. サーバーをテストします：

   uv run python main.py
   

セットアップと使用方法については、quick-data-mcp/README.md をご覧ください。

リソース

• MCP クライアント：https://modelcontextprotocol.io/clients
• Claude Code のリソースサポートに関する GitHub Issue：https://github.com/anthropics/claude-code/issuesç/545

AI コーディングを極める

基礎となるAI コーディングの原則を通じて、AI を使ったコーディングを学びましょう。

AI コーディングのヒントやテクニックについては、IndyDevDan の YouTube チャンネルをフォローしてください。

最高のエージェント型コーディングツール、Claude Codeをお使いください。