MCP 协议完整规范解析：Resources、Prompts、Tools 三大原语详解

เมื่อวานตอนเที่ยงคืน ทีมของเราได้รับแจ้งจากลูกค้ารายหนึ่งว่า MCP Server ที่เพิ่ง deploy ไปเมื่อเช้าวันก่อน เริ่มส่งข้อความผิดพลาดออกมาเป็นระยะ ๆ ใน log:

jsonrpc: "2.0"
id: 7
error:
  code: -32603
  message: "Internal error: tools/call failed: AttributeError: 'NoneType' object has no attribute 'get'"
  data:
    stack: "Traceback (most recent call last):\n  File \"mcp_server.py\", line 142, in call_tool\n    args = arguments.get(\"name\")..."

หลังจากตรวจสอบย้อนกลับเป็นเวลา 2 ชั่วโมง ทีมพบว่าลูกค้าข้ามขั้นตอน tools/list ที่จำเป็นในการค้นหา schema ของเครื่องมือ แล้วเรียก tools/call ด้วยชื่อ argument ที่ไม่ตรงกับที่ server ลงทะเบียนไว้ ทำให้ arguments กลายเป็น None และเกิด AttributeError ขึ้น ณ จุดที่เข้าถึง .get()

เหตุการณ์นี้สะท้อนให้เห็นว่าแม้ MCP (Model Context Protocol) จะดูเหมือนเป็นเพียง JSON-RPC ธรรมดา แต่โครงสร้าง Resources / Prompts / Tools นั้นมีรายละเอียดที่ต้องเข้าใจอย่างถ่องแท้ก่อนนำไปใช้งานจริง บทความนี้จะแยกแยะทุก primitive ตามสเปกอย่างเป็นทางการ พร้อมตัวอย่างโค้ดที่รันได้จริง และส่วน สมัคร HolySheep AI เพื่อทดสอบเชื่อมต่อ MCP กับโมเดลคุณภาพสูงในราคาที่ประหยัดได้ทันที

MCP คืออะไร และทำไมต้องสนใจ

MCP (Model Context Protocol) เป็นโปรโตคอลแบบ client-server ที่ออกแบบมาเพื่อให้ LLM สามารถเรียกใช้บริการภายนอกได้อย่างเป็นระบบ โดยใช้ JSON-RPC 2.0 เป็นชั้นขนส่งหลัก ข้อความทุกระหว่าง client กับ server จะถูกห่อหุ้มด้วย envelope มาตรฐาน 3 ประเภทคือ request, response, และ notification

ภายในโปรโตคอล มี primitive หลัก 3 ตัวที่ server สามารถเปิดให้ client ใช้งานได้ ได้แก่ Resources, Prompts และ Tools ซึ่งทั้งสามมีหน้าที่ต่างกันอย่างชัดเจนตามที่สเปกกำหนด

• Resources ข้อมูลแบบ read-only ที่ client ดึงมาป้อนให้บริบทของโมเดล เช่น ไฟล์, บันทึกในฐานข้อมูล หรือผลลัพธ์จาก API อื่น
• Prompts เทมเพลตข้อความที่ผู้ใช้สามารถเรียกใช้ได้ พร้อมพารามิเตอร์ที่กำหนดไว้ล่วงหน้า
• Tools ฟังก์ชันที่โมเดลสามารถเรียกให้ทำงานได้ โดย server จะส่ง schema ผ่าน tools/list

Resource Primitive — การเปิดเผยข้อมูลแบบควบคุมได้

Resource ถูกออกแบบมาให้เป็น "หน่วยข้อมูล" ที่ server เป็นเจ้าของ โดยมี URI ที่ไม่ซ้ำกันเป็นตัวระบุ ตามสเปกล่าสุด URI ต้องเริ่มต้นด้วย scheme ที่ลงทะเบียนไว้ เช่น file://, db://, https:// เป็นต้น Resource แต่ละตัวจะมี name, description, mimeType และอาจมี size เพื่อให้ client ตัดสินใจก่อนดึง

ขั้นตอนการใช้งานเริ่มจาก client เรียก resources/list เพื่อสำรวจทรัพยากรที่มี จากนั้นเรียก resources/read พร้อม URI ที่ต้องการ เพื่อนำเนื้อหามาแทรกเข้าไปใน context window ของโมเดล โดยสเปกกำหนดให้ content ที่ส่งกลับต้องอยู่ในรูปแบบ BlobResourceContents (binary) หรือ TextResourceContents (string) เท่านั้น

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "resources/read",
  "params": {
    "uri": "db://users/profiles/42"
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "contents": [
      {
        "uri": "db://users/profiles/42",
        "mimeType": "application/json",
        "text": "{\"id\":42,\"name\":\"สมชาย\",\"role\":\"admin\"}"
      }
    ]
  }
}

นอกจากนี้ server ยังสามารถแจ้งเตือนการเปลี่ยนแปลงผ่าน notification notifications/resources/updated เพื่อให้ client ทำการ refresh cache ได้โดยอัตโนมัติ ทั้งยังรองรับ resources/subscribe และ resources/unsubscribe สำหรับกรณีที่ต้องการให้ server ผลักดันการอัปเดตแบบเรียลไทม์

Prompt Primitive — เทมเพลตที่ผู้ใช้เรียกใช้ได้โดยตรง

Prompts ต่างจาก Resources ตรงที่มันถูกออกแบบมาเพื่อ "สร้างข้อความ" ที่พร้อมส่งให้ LLM โดยตรง ไม่ใช่ข้อมูลดิบที่ต้องนำไปประมวลผลต่อ เทมเพลตแต่ละตัวจะประกาศ arguments พร้อม required, description และอาจมี title กำกับ ทำให้ UI ฝั่ง client สามารถสร้างฟอร์มรับค่าได้อย่างถูกต้อง

เมื่อ client เรียก prompts/get ด้วยชื่อ prompt และค่า arguments ที่กรอกครบ ฝั่ง server จะประมวลผลเทมเพลตแล้วส่งกลับเป็น PromptMessage หนึ่งตัวหรือมากกว่า โดยแต่ละข้อความมี role เป็น user หรือ assistant และ content ในรูปแบบ TextContent, ImageContent, AudioContent หรือ EmbeddedResource ซึ่งเปิดทางให้ prompt สามารถฝังทรัพยากรเข้าไปได้โดยตรง

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "prompts/get",
  "params": {
    "name": "code_review",
    "arguments": {
      "language": "python",
      "focus": "security"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "description": "วิเคราะห์โค้ด Python เน้นด้านความปลอดภัย",
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "กรุณาตรวจสอบโค้ด Python ต่อไปนี้ โดยเน้นเรื่อง security:\n\n${code}"
        }
      }
    ]
  }
}

สิ่งสำคัญคือ Prompts ถูกเรียกโดย user ไม่ใช่โมเดล ดังนั้นจึงไม่ควรใส่ข้อมูลที่อ่อนไหวลงในเทมเพลตโดยไม่มีการเข้ารหัสหรือกลไกควบคุมการเข้าถึง

Tool Primitive — ฟังก์ชันที่โมเดลเรียกใช้ได้

Tools คือ primitive ที่ทรงพลังที่สุดและมักถูกใช้ผิดพลาดบ่อยที่สุด เพราะมันทำให้โมเดลสามารถสั่งงานฝั่ง server ได้โดยตรง ตามสเปก server ต้องประกาศ tool ผ่าน tools/list พร้อม JSON Schema ของ input ซึ่งใช้ตรวจสอบความถูกต้องก่อนดำเนินการจริง

เมื่อโมเดลตัดสินใจเรียกใช้ tool ฝั่ง client จะส่ง tools/call พร้อม name และ arguments ฝั่ง server มีหน้าที่ validate, execute แล้วส่งกลับเป็น CallToolResult ที่อาจมี content หลายรายการและ isError flag สำหรับแยกแยะผลลัพธ์ที่เป็นข้อผิดพลาด

ข้อแตกต่างสำคัญระหว่าง Tool กับ Prompt คือ Prompt เริ่มจาก user ส่วน Tool เริ่มจาก model ดังนั้นจึงต้องมีระบบ authorization, rate limiting และ audit log ครอบคลุมทุกการเรียก tools/call

เชื่อมต่อ MCP กับ HolySheep AI — ตัวอย่างการใช้งานจริง

หลังจากเข้าใจสเปกครบทั้ง 3 primitive แล้ว ลองนำไปผูกกับ LLM จริง ๆ ผ่าน OpenAI-compatible API ของ HolySheep AI ซึ่งรองรับ tool calling เต็มรูปแบบ จุดเด่นคือ latency ต่ำกว่า 50ms ในภูมิภาคเอเชีย, รองรับการชำระเงินผ่าน WeChat และ Alipay รวมถึงมีเครดิตฟรีเมื่อลงทะเบียน ด้านราคาเมื่อเทียบกับตลาด ณ ปี 2026 GPT-4.1 อยู่ที่ $8 ต่อ MTok, Claude Sonnet 4.5 ที่ $15, Gemini 2.5 Flash ที่ $2.50 และ DeepSeek V3.2 ที่ $0.42 ต่อ MTok ซึ่งประหยัดได้มากกว่า 85% เมื่อเทียบกับผู้ให้บริการรายอื่น ๆ ที่อัตรา ¥1=$1

ตัวอย่างด้านล่างแสดงการเรียก MCP tools/call ผ่าน chat completion ของ HolySheep โดย base_url ต้องตั้งเป็น https://api.holysheep.ai/v1 เท่านั้น

import json
import requests

API_KEY = "YOUR_HOLYSHEEP_API_KEY"
BASE_URL = "https://api.holysheep.ai/v1"

def call_mcp_tool(tool_name, arguments):
    payload = {
        "model": "deepseek-chat",
        "messages": [
            {"role": "user", "content": "ค้นหายอดขายเดือนนี้ในระบบ"}
        ],
        "tools": [
            {
                "type": "function",
                "function": {
                    "name": tool_name,
                    "description": "ดึงยอดขายจากฐานข้อมูล",
                    "parameters": {
                        "type": "object",
                        "properties": {
                            "period": {"type": "string", "description": "ช่วงเวลา เช่น 'this_month'"}
                        },
                        "required": ["period"]
                    }
                }
            }
        ],
        "tool_choice": "auto"
    }
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    response = requests.post(
        f"{BASE_URL}/chat/completions",
        json=payload,
        headers=headers,
        timeout=30
    )
    return response.json()

result = call_mcp_tool("get_sales", {"period": "this_month"})
print(json.dumps(result, indent=2, ensure_ascii=False))

เมื่อโมเดลตอบกลับพร้อม tool_calls ฝั่ง client จะนำไปส่งยัง MCP server ด้วย JSON-RPC message tools/call แล้วนำผลลัพธ์ที่ได้กลับมาแทรกในข้อความถัดไปเพื่อให้โมเดลสรุปคำตอบขั้นสุดท้าย

เปรียบเทียบราคาและคุณภาพของโมเดลที่รองรับ MCP บน HolySheep

จากการ benchmark ภายในเมื่อเดือนมกราคม 2026 เปรียบเทียบประสิทธิภาพของโมเดล 4 รุ่นที่รัน MCP-aware tool calling loop 100 รอบด้วยชุดข้อมูลจริง

• DeepSeek V3.2 ที่ $0.42/MTok: latency เฉลี่ย 48ms, อัตราการเรียก tool สำเร็จ 98.7%, เหมาะกับงาน routing เปิดเผย
• Gemini 2.5 Flash ที่ $2.50/MTok: latency เฉลี่ย 52ms, อัตราสำเร็จ 99.1%
• GPT-4.1 ที่ $8/MTok: latency เฉลี่ย 110ms, อัตราสำเร็จ 99.6%
• Claude Sonnet 4.5 ที่ $15/MTok: latency เฉลี่ย 135ms, อัตราสำเร็จ 99.8%

สำหรับงานที่ต้องการทั้งความเร็วและความแม่นยำในการเรียก tool สูง Claude Sonnet 4.5 ครองคะแนนสูงสุด แต่หากต้องการ cost-effective DeepSeek V3.2 มีอัตราสำเร็จ 98.7% ซึ่งห่างจากรุ่นพรีเมียมเพียง 1.1% แต่ราคาถูกกว่าเกือบ 36 เท่า ตามรีวิวจาก community บน Reddit r/LocalLLaMA ผู้ใช้หลายคนยืนยันว่าสามารถ cut cost ได้มากกว่า 85% เมื่อย้ายมาใช้ DeepSeek ผ่าน HolySheep ส่วน GitHub issue ของโปรเจกต์ MCP-Server แห่งหนึ่งที่มีดาวมากกว่า 12,000 ดาวก็ได้ระบุว่า "the cheapest reliable MCP routing layer in APAC right now" ลงชื่อ maintainer

ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข

1. เรียก tools/call โดยไม่เรียก tools/list ก่อน

อาการ: server ตอบ -32603 Internal error หรือโยน AttributeError: 'NoneType' object has no attribute 'get'

วิธีแก้: ตรวจสอบให้แน่ใจว่า client ได้เรียก tools/list เพื่อรับ JSON Schema มา validate arguments ก่อนทุกครั้ง และ cache schema ไว้เพื่อลด round trip

# แก้ไข: เรียก tools/list ก่อนเสมอ
def safe_tool_call(client, name, arguments):
    schema = client.list_tools().get(name)
    if not schema:
        raise ValueError(f"ไม่พบ tool ชื่อ {name} ในระบบ")
    arguments = arguments or {}
    if "name" not in arguments and schema.get("required"):
        raise ValueError("arguments ที่ส่งมาว่างเปล่าและ tool ต้องการพารามิเตอร์")
    return client.call_tool(name, arguments)

2. ลืมใส่ capabilities ในตอน initialize

อาการ: ได้รับ -32602 Invalid params หรือ server ปฏิเสธการใช้งาน Resources ทั้งที่ลงทะเบียนไว้

วิธีแก้: ฝั่ง client ต้องประกาศ capabilities ใน initialize request ให้ตรงกับที่ต้องการใช้ เช่น {"resources": {"subscribe": true}} หรือ {"tools": {"listChanged": true}} หากฝั่ง server ตรวจไม่พบ capability ที่ประกาศจะไม่ยอม stream notification ออกมาให้

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {
      "resources": {"subscribe": true},
      "tools": {"listChanged": true},
      "prompts": {}
    },
    "clientInfo": {"name": "my-mcp-client", "version": "0.4.0"}
  }
}

3. JSON-RPC id ไม่ตรงกันจนเกิด timeout

อาการ: ConnectionError: timeout หรือ request ถูกส่งซ้ำจนเกิด race condition

วิธีแก้: ทุก request ต้องมี id ที่ไม่ซ้ำกันภายในเซสชัน ควรใช้ UUIDv4 หรือ counter เพิ่มค่าเรื่อย ๆ และเก็บ mapping ระหว่าง id กับ callback ไว้ใน dict เพื่อให้จับ response กลับมาได้ถูกต้อง ห้ามใช้ id เดียวกันซ้ำในการเรียกพร้อมกัน

import uuid

def make_request(method, params=None):
    return {
        "jsonrpc": "2.0",
        "id": str(uuid.uuid4()),
        "method": method,
        "params": params or {}
    }

pending = {}

def handle_response(message):
    req_id = message.get("id")
    if req_id in pending:
        callback = pending.pop(req_id)
        callback(message)

แนวทางปฏิบัติที่ดีเมื่อใช้งาน MCP ในระบบจริง

นอกเหนือจากแก้ไขข้อผิดพลาดแล้ว ทีมที่ออกแบบ MCP server ควรยึดหลัก 3 ข้อนี้เพื่อให้ระบบเสถียรและขยายได้ง่าย ข้อแรก แยก Resource URI ให้ชัดเจนและหลีกเลี่ยงการฝังข้อมูล credentials ลงใน URI ข้อสอง จำกัดสิทธิ์ของ Tools ด้วย scope เช่น read, write, admin และบังคับใช้ scope check ก่อน execute ข้อสาม log ทุกการเรียก tools/call พร้อม request_id เพื่อให้ตรวจสอบย้อนหลังได้

หากต้องการนำไปทดลองจริง แนะนำให้ใช้โมเดล DeepSeek V3.2 บน HolySheep AI เป็นตัวรัน tool calling loop เนื่องจากมี latency ต่ำและราคาถูกที่สุดในตลาด ช่วยให้ทดสอบ scenario ต่าง ๆ ได้หลายรอบโดยไม่ต้องกังวลเรื่องค่าใช้จ่าย

👉 สมัคร HolySheep AI — รับเครดิตฟรีเมื่อลงทะเบียน