MCP Books Service

🚀 博客項目中的MCP實現

本項目展示了在博客應用程序系統裡運用Model Context Protocol (MCP)的具體實現。它由三大主要組件構成，各組件協同運作，實現了語言模型與結構化數據操作的無縫集成。

🚀 快速開始

本項目由三個主要組件組成，各組件協同工作以實現語言模型與結構化數據操作的無縫集成。以下是項目的快速啟動步驟：

1. 運行mock服務：

cd books-mock-service
npm run dev

2. 在新終端中運行客戶端：

cd mcp-client
python client.py

3. 輸入查詢：輸入提示的查詢，輸入 'exit' 可退出。

✨ 主要特性

• 類型安全：Books MCP Server 基於 TypeScript 構建，確保類型安全。
• MCP 實現：採用 @modelcontextprotocol/sdk 進行 MCP 實現。
• 輕量級且易擴展：Books Mock Service 使用 Express.js 構建，輕量級且易於擴展。
• LLM 集成：MCP Client 使用 langchain_ollama 進行 LLM 集成。
• 交互式 CLI 界面：MCP Client 提供交互式 CLI 界面，方便用戶操作。

📦 安裝指南

1. Books MCP Server 安裝

cd books-mcp-server
npm install
npm run build

2. Books Mock Service 安裝

cd books-mock-service
npm install
npm run dev

3. MCP Client 安裝

cd mcp-client
# 創建並激活虛擬環境（推薦）
python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
# 安裝依賴項（需要requirements.txt文件）
pip install langchain-ollama mcp-use

💻 使用示例

基礎用法

1. 運行 mock 服務：

cd books-mock-service
npm run dev

2. 在新終端中運行客戶端：

cd mcp-client
python client.py

3. 輸入提示的查詢。輸入 'exit' 退出。

📚 詳細文檔

項目結構

.
├── books-mcp-server/     # 基於TypeScript的MCP服務器實現
│   ├── build/           # 編譯後的JavaScript文件
│   ├── src/             # 源TypeScript文件
│   └── package.json     # 服務器依賴和腳本
├── books-mock-service/  # 書籍數據模擬服務
│   └── server.js        # Express.js mock服務器
└── mcp-client/         # 基於Python的MCP客戶端實現
    └── client.py       # 主客戶端應用程序

組件

1. Books MCP Server

一個基於 TypeScript 的 MCP 服務器，負責處理客戶端與模擬服務之間的通信協議。

• 使用 TypeScript 構建以確保類型安全
• 採用 @modelcontextprotocol/sdk 進行 MCP 實現
• 運行在 stdio 傳輸層上

2. Books Mock Service

一個簡單的 Express.js 服務器，模擬書籍數據服務。

• 提供書籍相關操作的 mock 端點
• 使用 Express.js 構建
• 輕量級且易於擴展

3. MCP Client

一個基於 Python 的客戶端，使用 MCP 協議與語言模型集成。

• 使用 langchain_ollama 進行 LLM 集成
• 實現 MCPAgent 以處理查詢
• 提供交互式 CLI 界面

🔧 技術細節

開發

• MCP 服務器使用 TypeScript 構建。在 src 目錄中進行更改後，使用 npm run build 重建
• mock 服務可以通過添加新的路由到 server.js 來擴展
• 客戶端可以根據需要修改 client.py 中的 LLM 配置