README.md

Basic Calculator MCP Service

บริการนี้ให้การดำเนินการเครื่องคิดเลขพื้นฐานผ่าน Model Context Protocol (MCP) โดยใช้ Spring Boot กับ WebFlux transport ออกแบบมาเป็นตัวอย่างง่ายๆ สำหรับผู้เริ่มต้นที่ต้องการเรียนรู้เกี่ยวกับการใช้งาน MCP

สำหรับข้อมูลเพิ่มเติม ดูได้ที่เอกสารอ้างอิง MCP Server Boot Starter

การใช้งานบริการ

บริการนี้เปิดเผย API endpoints ต่อไปนี้ผ่านโปรโตคอล MCP:

• add(a, b): บวกตัวเลขสองตัวเข้าด้วยกัน
• subtract(a, b): ลบตัวเลขตัวที่สองออกจากตัวแรก
• multiply(a, b): คูณตัวเลขสองตัว
• divide(a, b): หารตัวเลขตัวแรกด้วยตัวที่สอง (ตรวจสอบกรณีหารด้วยศูนย์)
• power(base, exponent): คำนวณเลขยกกำลัง
• squareRoot(number): คำนวณรากที่สอง (ตรวจสอบกรณีเลขลบ)
• modulus(a, b): คำนวณเศษเหลือจากการหาร
• absolute(number): คำนวณค่าสัมบูรณ์

Dependencies

โปรเจกต์นี้ต้องการ dependencies หลักดังต่อไปนี้:

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
</dependency>

การสร้างโปรเจกต์

สร้างโปรเจกต์โดยใช้ Maven:

./mvnw clean install -DskipTests

การรันเซิร์ฟเวอร์

การใช้ Java

java -jar target/calculator-server-0.0.1-SNAPSHOT.jar

การใช้ MCP Inspector

MCP Inspector เป็นเครื่องมือที่ช่วยให้โต้ตอบกับบริการ MCP ได้ง่ายขึ้น วิธีใช้กับบริการเครื่องคิดเลขนี้:

1. ติดตั้งและรัน MCP Inspector ในหน้าต่างเทอร์มินัลใหม่:

   npx @modelcontextprotocol/inspector

2. เข้าถึงเว็บ UI โดยคลิกที่ URL ที่แอปแสดง (โดยปกติจะเป็น http://localhost:6274)

3. ตั้งค่าการเชื่อมต่อ:

   • ตั้งค่า transport type เป็น "SSE"
   • ตั้งค่า URL เป็น SSE endpoint ของเซิร์ฟเวอร์ที่กำลังรัน: http://localhost:8080/sse
   • คลิก "Connect"

4. ใช้งานเครื่องมือ:

   • คลิก "List Tools" เพื่อดูรายการการดำเนินการเครื่องคิดเลขที่มี
   • เลือกเครื่องมือแล้วคลิก "Run Tool" เพื่อรันการดำเนินการ

ข้อจำกัดความรับผิดชอบ:
เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษาอัตโนมัติ Co-op Translator แม้เราจะพยายามให้ความถูกต้องสูงสุด แต่โปรดทราบว่าการแปลอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่ถูกต้อง เอกสารต้นฉบับในภาษาต้นทางถือเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ ขอแนะนำให้ใช้บริการแปลโดยผู้เชี่ยวชาญมนุษย์ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดใด ๆ ที่เกิดจากการใช้การแปลนี้