# NYCU Library MCP AI Assistant 使用手冊

## 簡介

NYCU Library AI Assistant 是一個基於 MCP (Model Context Protocol) 的服務，讓陽明交大的學生可以透過 ChatGPT 或 Claude 等 AI 助手，用自然對話的方式直接查詢圖書館資源。

你可以做到：
- 📚 **查詢個人借閱記錄**：「我現在借了什麼書？」「哪本書快到期了？」
- 🔍 **搜尋館藏資源**：「幫我找量子計算的書」「有沒有 Nature 期刊？」
- 📄 **學術論文搜尋**：透過 Semantic Scholar 查找研究論文

所有查詢都會自動認證你的學生身份，直接存取你的個人借閱資料和學校圖書館館藏。

> **💡 已完成設定？** 直接前往服務使用說明：
> * [Library Service - 圖書館服務](#Library-Service---圖書館服務)
> * [Semantic Scholar Service - 學術論文搜尋](#Semantic-Scholar-Service---學術論文搜尋)

## 設置方式 (Setup)

### 前置需求

- 陽明交大學生帳號
- ChatGPT Plus 或 Claude Plus (都需要訂閲)
- 未訂閲使用還待開發中

### ChatGPT 設置步驟

> **下面是詳細的 ChatGPT 設定，如果設定完，可直接跳到** [使用方法](#Library-Service---圖書館服務)

0. 開啓GPT：進入 **Settings** → **Apps & Connectors** → **Advanced Settings**

<img src="https://hackmd.io/_uploads/r1ae9ube-g.png" width="80%" style="border: 1px solid #ddd;" alt="image">

1. 開啟 ChatGPT，進入 **Settings** → **Apps & Connectors** → **Create** 👇

<img src="https://hackmd.io/_uploads/SJwYtdWeWe.png" width="80%" style="border: 1px solid #ddd;" alt="image">

2. 出現列表並👇，填入以下資訊：
- Server Name: `NYCU Library` （任意名字）
- MCP Server URL: `https://mcp.lib.nycu.edu.tw/library`

<img src="https://hackmd.io/_uploads/BJunF_-xbg.png" width="40%" style="border: 1px solid #000;" alt="image">

3. 儲存設定後，會提示進行 OAuth 登入, 使用學校帳號完成認證。
5. 登入成功畫面如下 👇

<img src="https://hackmd.io/_uploads/Sy3JnO-lbl.png" width="50%" style="border: 1px solid #ddd;" alt="Pasted image 20251112093450">

6. 成功之後，在ChatGPT 的對話框，左側 “+”，點擊->"More" 就能看到 我們剛剛建立的 MCP Server 名字。然後點擊我們的Server

<img src="https://hackmd.io/_uploads/ryoKh_-g-x.png" width="50%" style="border: 1px solid #ddd;" alt="image-72">

8. 或者直接在對話框輸入”/“ + 剛剛我們設定 MCP 時候的名稱打入，系統會自動顯示。然後點擊。

<img src="https://hackmd.io/_uploads/SkpsRubx-g.png" width="50%" style="border: 1px solid #ddd;" alt="image-75">

9. 成功之後會顯示如下。
<img src="https://hackmd.io/_uploads/r1fQCuWeWg.png" width="50%" style="border: 1px solid #ddd;" alt="image">

### Claude 設置步驟
> **下面是詳細的 Claude 設定，如果設定完，可直接跳到** [使用方法](#Library-Service---圖書館服務)

1. 開啟 Claude，點擊右上角的 **Settings**

<img src="https://hackmd.io/_uploads/By1Z1tWg-l.png" width="80%" style="border: 1px solid #ddd;" alt="image">

2. 填入以下資訊：**Library Service**:
- Server Name: `NYCU Library`
- URL: `https://mcp.lib.nycu.edu.tw/library`

<img src="https://hackmd.io/_uploads/HkSSkKWeZg.png" style="border: 1px solid #ddd;" alt="image">

3. 儲存設定後，按下 "**Connect**"
4. 使用學校帳號完成認證 -> 如果顯示右圖就算連接成功 👇
<img src="https://hackmd.io/_uploads/SJoTWYbgWx.png" style="border: 1px solid #ddd;" alt="image">

5. 加入MCP 連接，確保允許所有功能。

<img src="https://hackmd.io/_uploads/B1oD7YWx-l.png" width="80%" style="border: 1px solid #ddd;" alt="image">

### OAuth 認證說明

首次使用時，系統會要求你登入陽明交大 IDM 系統進行身份驗證：
1. 點擊 OAuth 登入連結
2. 輸入學校帳號密碼
3. 授權 AI Assistant 存取你的圖書館資料
4. 認證完成後，即可開始使用

認證 token 有效期為 1 小時，過期後需要重新登入。

## Library Service - 圖書館服務

Library Service 整合了陽明交大圖書館的 Primo 系統，提供個人借閱管理和館藏搜尋功能。

### 個人借閱記錄 (Personal Records)

#### 查詢目前借閱的書籍

直接用自然語言詢問你的借閱狀況：

**範例對話：**
- 「我現在借了什麼書？」
- 「我的借書記錄」
- 「Show me my current loans」

系統會回傳：
- 📖 書名與作者
- 📅 借書日期與到期日
- 🔄 續借次數
- 📍 借閱櫃檯與館藏位置

#### 查詢預約與預借

查看你目前的預約請求：

**範例對話：**
- 「我有預約哪些書？」
- 「我的預約記錄」
- 「Check my holds and requests」

系統會回傳：
- 📚 預約書籍資訊
- 📍 取書地點
- ⏳ 預約狀態（處理中/可取書）
- 📅 預約日期

### 館藏搜尋 (Primo Search)

Primo 是陽明交大圖書館的館藏探索系統，整合了紙本書籍、電子資源、期刊、論文等多種資料。

#### 模糊搜尋

用自然對話探索你感興趣的主題，AI 會幫你組織查詢並解讀結果：

**範例對話：**
- 「我對電子物理感興趣，幫我找找相關資料」
- 「推薦一些量子計算的書」
- 「找一些關於機器學習的資源」
- 「有什麼資料結構與演算法的教材？」

系統特色：
- ✅ 支援中文和英文查詢
- ✅ AI 會自動判斷最適合的關鍵字
- ✅ 可以進一步追問：「有沒有更進階的？」「找一些入門的」

每筆結果包含：
- 📖 標題與作者
- 📅 出版年份
- ✅ 館藏狀態（可借/已借出/僅館內閱讀）
- 📍 實體館藏位置
- 🔗 線上資源連結

#### 作者/標題搜尋

當你知道明確的書名或作者時，可以直接指定搜尋：

**範例對話：**
- 「找 Donald Knuth 的書」
- 「查《演算法導論》這本書」
- 「Search for books by Richard Feynman」
- 「Find "Introduction to Algorithms"」

精確搜尋的優勢：
- 🎯 直接命中目標資源
- 📚 可以找到該作者的所有著作
- 🔄 可以追問：「還有其他版本嗎？」「電子版在哪裡？」

*（截圖位置：作者/標題搜尋範例）*

#### 期刊搜尋

查詢特定學術期刊的館藏：

**範例對話：**
- 「找 Nature 期刊」
- 「有沒有訂閱 IEEE Transactions?」
- 「查詢 Science 期刊的電子版」
- 「Find Journal of Machine Learning Research」

期刊查詢特色：
- 📰 顯示訂閱年份範圍
- 💻 電子版存取連結
- 🏛️ 紙本館藏位置
- 🔍 可以進一步搜尋該期刊內的文章

#### 資源類型篩選

系統支援多種資源類型，你可以指定搜尋特定類型：

**資源類型：**
- 📘 **Books** - 紙本與電子書
- 📄 **Articles** - 期刊文章
- 🎥 **Videos** - 影音資料
- 🎓 **Dissertations** - 學位論文
- 📰 **Magazines** - 雜誌

**範例對話：**
- 「找機器學習的『影片教材』」
- 「有沒有關於量子物理的『學位論文』？」
- 「Search for quantum computing 『articles』」

#### 分頁瀏覽

每次搜尋預設回傳 10 筆結果，你可以繼續瀏覽：

**範例對話：**
- 「還有更多結果嗎？」
- 「Show me the next page」
- 「第 2 頁」

---

## Semantic Scholar Service - 學術論文搜尋

**Domain URL**: https://mcp.lib.nycu.edu.tw/semantic-scholar-mcp

Semantic Scholar 是一個免費的學術搜尋引擎，由 AI2 (Allen Institute for AI) 開發，專注於電腦科學和生物醫學領域的論文搜尋。

### API Key 設置

Semantic Scholar Service 需要你使用個人的 API Key 才能使用。這樣設計的原因是：
- 🔒 保護系統資源，避免超過 API 使用限制
- 📊 讓管理員可以追蹤使用統計
- ⚡ 每個學生有獨立的 API 配額

### 步驟 1：申請 Semantic Scholar API Key

1. 前往申請頁面：**https://www.semanticscholar.org/product/api#api-key-form**
2. 填寫表單：
- Name：你的姓名
- Email：學校信箱（@nycu.edu.tw）
- Organization：`National Yang Ming Chiao Tung University`
- Use Case：`Academic research for NYCU studies`
3. 提交後等待審核（通常 1-3 個工作天）
4. API Key 會寄到你的信箱，收到後請妥善保存

### 步驟 2：設定 API Key

1. 前往：**https://mcp.lib.nycu.edu.tw/keys/student**
2. 使用學校帳號登入
3. 貼上 API Key 並點擊「儲存」

### 步驟 3：添加 Semantic Scholar MCP Server

在 ChatGPT 或 Claude 中添加新的 MCP Server：
- **Server Name**: `Semantic Scholar`
- **URL**: `https://mcp.lib.nycu.edu.tw/semantic-scholar-mcp`

設定步驟與 Library Service 相同[（參考前面的設置方式章節）](#設置方式-(Setup))
。

#### API Key 管理

- 🔄 **更新 Key**：直接在同一頁面輸入新的 Key 並儲存
- 🗑️ **刪除 Key**：點擊「刪除」按鈕即可移除
- 🔐 **安全性**：API Key 使用 Fernet 加密儲存在 Redis，確保安全

### 使用範例

完成 API Key 設置後，就可以透過 AI 助手搜尋學術論文：

**範例對話：**
- 「找關於機器學習的論文」
- 「Search for papers on quantum computing」
- 「Yann LeCun 發表過什麼論文？」
- 「Find recent papers about transformer models」
- 「有沒有關於 BERT 的論文？」

系統會回傳：
- 📄 論文標題與摘要
- 👥 作者列表
- 📅 發表年份
- 📊 引用次數
- 🔗 論文連結（DOI, ArXiv 等）

進階查詢：
- 「找 2023 年之後的論文」
- 「只要高引用的論文」
- 「有沒有綜述文章？」

## 常見問題 (FAQ)

### Q: 為什麼我的認證過期了？

A: OAuth Token 有效期為 1 小時，過期後需要重新登入。這是為了保護你的帳號安全。

### Q: 我可以同時在 ChatGPT 和 Claude 使用嗎？

A: 可以！兩個平台各自獨立認證，互不影響。

### Q: Semantic Scholar 沒有我要找的論文？

A: Semantic Scholar 主要收錄電腦科學和生物醫學領域的論文。其他領域的論文建議使用 Library Service 搜尋期刊文章。

### Q: 我的 API Key 安全嗎？

A: API Key 使用 Fernet 加密儲存在 Redis，只有你本人可以查看和修改。系統管理員無法看到你的明文 API Key。

### Q: 搜尋結果可以直接借書嗎？

A: 目前只提供查詢功能。如需借書、續借、預約，請點擊結果中的連結前往圖書館系統操作，或直接到圖書館櫃檯辦理。

---

## 聯絡我們

如有問題或建議，歡迎聯絡：

- 📧 Email: [圖書館聯絡信箱]
- 🌐 陽明交大圖書館網站: [圖書館網址]
- 🐛 問題回報: [GitHub Issues 或其他回報管道]

---

**版本資訊**
- 文件版本: 1.0
- 最後更新: 2025-11-11
- 服務網址: https://mcp.lib.nycu.edu.tw