Modelcontextprotocolclient

🚀 ModelContextProtocolClient

本項目是一個基於Spring Boot的客戶端應用程序，它展示瞭如何運用不同的傳輸方法（WebFlux SSE、Stdio）與MCP服務器進行通信，為開發者提供了多樣化的通信解決方案。

🚀 快速開始

環境配置

1. 在項目根目錄下創建一個.env文件，並添加以下內容：

BRAVE_SEARCH_API_KEY=你的Brave搜索API密鑰
WEATHER_API_KEY=你的天氣API密鑰

2. 克隆MCP服務器倉庫：

git clone https://github.com/InnoBridge/ModelContextProtocolServer

3. Docker環境配置：
   • 更新docker-compose.yml中的卷映射：

modelcontextprotocolclient_application
...
volumes:
  - .:/app
  - /var/run/docker.sock:/var/run/docker.sock
  - ./local/root:/root
  - ../{ModelContextProtocolServer所在路徑}:/ModelContextProtocolServer

- 啟動Docker容器：

sudo docker compose up

- 構建並運行MCP服務器：

# 在新的終端窗口中
sudo docker exec -it modelcontextprotocolserver-application sh
cd /app
./mvnw clean install
./mvnw spring-boot:run

- 構建並運行客戶端：

# 在另一個新的終端窗口中
docker exec -it modelcontextprotocolclient-application sh
./mvnw spring-boot:run

💻 使用示例

可用端點

WebFlux傳輸

• GET /webflux/tools：列出所有可用工具。
• POST /webflux/calculate：使用計算器工具進行計算。

curl -X POST "http://localhost:8080/webflux/calculate?operation=add&a=5&b=3"

• POST /webflux/weather：獲取天氣信息。

curl -X POST "http://localhost:8080/webflux/weather?location=San%20Francisco&format=celsius"

Stdio傳輸

• GET /stdio/tools：列出所有可用工具。
• POST /stdio/calculate：使用計算器工具進行計算。

curl -X POST "http://localhost:8080/stdio/calculate?operation=add&a=5&b=3"

• POST /stdio/weather：獲取天氣信息。

curl -X POST "http://localhost:8080/stdio/weather?location=San%20Francisco&format=celsius"

BraveSearch傳輸

• GET /tools/bravesearch：列出可用工具。
• POST /bravesearch：執行網絡搜索。

curl -X POST "http://localhost:8080/bravesearch?query=spring%20boot"

🔧 技術細節

配置

該應用程序支持多種傳輸配置：

1. WebFlux SSE傳輸（默認）：使用Server - Sent Events與服務器通信，服務器必須以WebFlux模式運行。
2. Stdio傳輸：使用標準輸入輸出與服務器通信，會自動啟動服務器JAR文件並以stdio模式運行。
3. BraveSearch傳輸：使用BraveSearch API進行通信，需要在.env文件中添加BRAVE_SEARCH_API_KEY，可從Brave Search API獲取API密鑰。
4. 天氣API：用於WebFlux和Stdio傳輸的天氣信息查詢，需要在.env文件中添加WEATHER_API_KEY，可從WeatherAPI獲取API密鑰。