MCP Book Search

🚀 圖書館搜索 MCP 服務器

本項目是一個通過 Calil API 實現的圖書館搜索用 MCP (模型上下文協議) 服務器。藉助該服務器，Claude 等 AI 助手能夠直接訪問日本全國的圖書館信息，為信息檢索帶來便利。

🚀 快速開始

前提條件

• 需獲取 Calil API 密鑰，可前往 Calil API 儀表盤 進行獲取。
• 安裝 Node.js v16 以上版本。

本地運行

1. 安裝依賴項：

npm install

2. 設置環境變量： 創建 .env 文件，並添加以下內容：

CALIL_APPLICATION_KEY=你的CalilAPI密鑰

3. 項目構建：

npm run build

4. 啟動服務器：

npm start

在 Claude Desktop 中的設置

在 Claude Desktop 的配置文件（通常位於 ~/.config/Claude Desktop/claude_desktop_config.json）中添加以下條目：

{
  "mcpServers": {
    "book-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/dist/index.js"
      ],
      "env": {
        "CALIL_APPLICATION_KEY": "你的CalilAPI密鑰"
      }
    }
  }
}

連接測試

通過以下命令驗證服務器是否正常運行：

npm test

此測試將驗證以下功能：

• Calil API 的連接
• 圖書館信息的獲取
• 工具調用處理

✨ 主要特性

• 地域搜索：可按都道府縣名搜索圖書館信息。
• 信息獲取：能獲取圖書館的基本信息，如圖書館名或所在地等。
• AI 集成：可作為 AI 助手的工具使用。

💻 使用示例

基礎用法

當前 MCP 服務器提供了一些實用工具，以下是部分工具的使用示例：

get_libraries_by_prefecture

按指定都道府縣搜索圖書館信息。

# 調用 get_libraries_by_prefecture 工具搜索東京都的圖書館信息
# 這裡假設存在調用該工具的函數 call_tool
result = call_tool('get_libraries_by_prefecture', {'prefecture': '東京都'})
print(result)

參數：

• prefecture：都道府縣名（例如：「東京都」、「大阪府」）

返回值：該都道府縣內的圖書館系統和圖書館信息的列表

search_books

（目前為佔位符實現）搜索書籍。

# 調用 search_books 工具搜索包含 "人工智能" 關鍵字的書籍
result = call_tool('search_books', {'query': '人工智能'})
print(result)

參數：

• query：搜索關鍵字

📚 詳細文檔

可用工具

當前 MCP 服務器提供以下工具：

🔧 技術細節

本項目基於 Calil API 構建 MCP 服務器，使得 AI 助手能夠與日本全國的圖書館信息進行交互。通過 Node.js 實現服務器的搭建和運行，利用環境變量管理 Calil API 密鑰，確保信息的安全性。在 Claude Desktop 中，通過配置文件將服務器集成到 AI 助手的使用環境中。

📄 許可證

本項目採用 MIT 許可證。