MCP Academy · レッスン

適切なMIMEタイプを設定する

コンテンツがテキスト、JSON、その他のどれであるかをクライアントに伝えます。

レッスン 4/413 ステップ

「適切なMIMEタイプを設定する」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。

MIME タイプとは

MIME タイプとは、リソースに含まれるコンテンツの種類をクライアントに伝える短いラベルです。プレーンテキスト、JSON、画像などが該当します。

重要な理由

このラベルによって、クライアントはコンテンツを正しく表示・解析できます。ラベルがないと、JSON をプレーンテキストとして表示したり、バイナリデータを誤って処理したりする可能性があります。🏷️

テキストのデフォルト

何も指定しない場合、MCP はtext/plainとみなします。メモやドキュメントには適していますが、構造化データにはより正確なタイプが必要です。

よく使うタイプ

よく使うものは数種類です。文章には text/plain、データには application/json、モデルが解析できる書式付きドキュメントには text/markdown を使います。

FastMCP で宣言する

resource デコレーターのmime_type引数でタイプを設定し、クライアントが本文を正確に読み取れるようにします。

@mcp.resource("data://stats", mime_type="application/json")
def stats():
    return '{"users": 42}'

JSON を正しく扱う

JSON の場合は application/json と指定し、有効な JSON 文字列を返します。json ライブラリを使って組み立てれば、引用符やエスケープを常に正しく処理できます。

import json

@mcp.resource("data://stats", mime_type="application/json")
def stats():
    return json.dumps({"users": 42})

ドキュメントには Markdown

README やガイドを提供する場合は、text/markdownを使います。対応しているクライアントなら、記号をそのまま表示せず、見出しやリストとして表示できます。

@mcp.resource("docs://readme", mime_type="text/markdown")
def readme():
    return "# Welcome\nGetting started..."

タイプをコンテンツに合わせる

タイプは本文の内容を正確に表す必要があります。プレーンテキストを JSON として指定すると、クライアントが解析を試みて失敗するため、必ず両者を一致させてください。

バイナリには注意が必要

画像や PDF には image/png のようなバイナリのMIME タイプを設定し、テキストプロトコルで安全に扱えるよう、バイト列を base64 エンコードして送信します。

拡張子から判定する

ファイルを提供するときは、Python がファイル名からタイプを推測できます。mimetypes ライブラリが拡張子を標準の MIME タイプに対応付けてくれます。

import mimetypes
mt, _ = mimetypes.guess_type("report.json")
# mt == "application/json"

小さな契約

MIME タイプは小さな契約だと考えてください。バイト列の形をクライアントに約束し、解析前に双方が認識を合わせられるようにします。

クイックチェック

構造化データに適したタイプを選んでください。

まとめ

MIME タイプは、リソースをどのように読み取るかをクライアントに伝えます。mime_type を使って text、JSON、markdown、またはバイナリを設定し、内容と一致させてください。🏷️

無料で開始

AI チューターと学ぶ Python — 無料

ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。

コース
30
レッスン
120

よくある質問

「適切なMIMEタイプを設定する」レッスンは無料ですか?

はい。「適切なMIMEタイプを設定する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。

「適切なMIMEタイプを設定する」で何を学びますか?

コンテンツがテキスト、JSON、その他のどれであるかをクライアントに伝えます。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

MCP Academyを始めるのに経験は必要ですか?

事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。

「適切なMIMEタイプを設定する」レッスンにはどのくらい時間がかかりますか?

ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このMCP Academyレッスンでコードを書いて実行できますか?

はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. リソースURIを理解する
  2. 静的なテキストリソースを提供する
  3. ディスクからファイルを読み取る
  4. 適切なMIMEタイプを設定する
← MCP Academyに戻る