README.md

Basic Calculator MCP Service

這個服務透過 Model Context Protocol (MCP) 使用 Spring Boot 搭配 WebFlux 傳輸，提供基本計算機運算功能。它是為初學者學習 MCP 實作設計的簡單範例。

更多資訊請參考 MCP Server Boot Starter 參考文件。

使用服務

服務透過 MCP 協定公開以下 API 端點：

• add(a, b)：將兩個數字相加
• subtract(a, b)：從第一個數字中減去第二個數字
• multiply(a, b)：將兩個數字相乘
• divide(a, b)：用第一個數字除以第二個數字（含零值檢查）
• power(base, exponent)：計算數字的次方
• squareRoot(number)：計算平方根（含負數檢查）
• modulus(a, b)：計算除法的餘數
• absolute(number)：計算絕對值

依賴項目

專案需要以下主要依賴：

<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. 透過應用程式顯示的網址開啟網頁介面（通常是 http://localhost:6274）

3. 設定連線：

   • 傳輸類型選擇「SSE」
   • URL 設為你正在執行的伺服器 SSE 端點：http://localhost:8080/sse
   • 點擊「Connect」

4. 使用工具：

   • 點擊「List Tools」查看可用的計算機操作
   • 選擇工具並點擊「Run Tool」執行操作

免責聲明：
本文件係使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們努力追求準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件之母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而產生之任何誤解或誤譯負責。