MCP Aladin Books Server

🚀 阿拉丁圖書搜索 MCP 服務器 (Node.js)

這是一個利用阿拉丁圖書搜索 API 的 MCP（Model Context Protocol）服務器，可幫助用戶通過多種方式搜索圖書信息。

🚀 快速開始

要使用此 MCP 服務器，需先獲取阿拉丁的 API 密鑰，並完成 DXT 安裝與服務器配置。

阿拉丁 API 密鑰獲取

1. 訪問 阿拉丁 TTB 網站。
2. 完成註冊並登錄。
3. 申請 API 密鑰。

DXT 安裝

1. 下載 DXT 文件。
2. 在雲端桌面選擇【設置】-【擴展程序】。
3. 將下載的 DXT 文件拖放至指定區域。
4. 輸入 API 密鑰。

服務器配置

1. 安裝依賴並構建項目

npm install
npm run build

2. 在 MCP 客戶端輸入信息

{
  "mcpServers": {
    "aladin-books": {
      "command": "node",
      "args": [
        "<路徑>/mcp-aladin-books-server/dist/index.js"
      ],
      "env": {
        "ALADIN_TTB_KEY": "阿拉丁_TTB_密鑰"
      }
    }
  }
}

✨ 主要特性

• 圖書搜索：支持通過書名、作者、出版社和關鍵詞進行圖書搜索。
• 詳細信息查詢：可根據 ISBN 查詢圖書詳細信息。
• 暢銷書查詢：能獲取阿拉丁暢銷書列表，支持按類別搜索。
• 類別搜索：可搜索和查看圖書類別，優先顯示上級類別。

📦 安裝指南

依賴安裝與構建

npm install
npm run build

MCP 客戶端信息配置

{
  "mcpServers": {
    "aladin-books": {
      "command": "node",
      "args": [
        "<路徑>/mcp-aladin-books-server/dist/index.js"
      ],
      "env": {
        "ALADIN_TTB_KEY": "阿拉丁_TTB_密鑰"
      }
    }
  }
}

💻 使用示例

基礎用法

可在 MCP 客戶端使用以下代碼進行操作：

// 圖書搜索
await callTool('search_books', {
  query: 'Python',
  searchType: 'Title',
  maxResults: 5
});

// 圖書詳細信息
await callTool('get_book_detail', {
  isbn: '9788966262755'
});

// 全部圖書暢銷書查詢
await callTool('get_bestsellers', {
  maxResults: 10
});

// 按類別查詢圖書暢銷書
await callTool('get_bestsellers', {
  maxResults: 10,
  categoryId: '798' // 例如：計算機類別
});

// 查詢新書全量列表
await callTool('get_new_books', {
  maxResults: 10
});

// 按類別查詢新書
await callTool('get_new_books', {
  maxResults: 10,
  categoryId: '798' // 例如：計算機類別
});

// 查詢值得關注的新書列表
await callTool('get_special_new_books', {
  maxResults: 10
});

// 查詢編輯推薦列表
await callTool('get_editor_choice', {
  maxResults: 10
});

// 查詢博主暢銷書列表（僅國內圖書）
await callTool('get_blogger_best', {
  maxResults: 10,
  categoryId: '798' // 例如：計算機類別
});

// 搜索圖書類別
await callTool('search_categories', {
  searchTerm: '小說',
  maxResults: 10
});

// 查詢常用主要類別列表
await callTool('get_popular_categories', {
  limit: 10
});

// 以表格形式顯示圖書信息（搜索）
await callTool('format_books_table', {
  type: 'search',
  query: 'Python',
  searchType: 'Title',
  maxResults: 5
});

// 以表格形式顯示圖書信息（暢銷書）
await callTool('format_books_table', {
  type: 'bestseller',
  maxResults: 10,
  categoryId: '798'
});

// 以表格形式顯示圖書信息（新書全量）
await callTool('format_books_table', {
  type: 'new_books',
  maxResults: 10
});

// 以表格形式顯示圖書信息（值得關注的新書）
await callTool('format_books_table', {
  type: 'special_new_books',
  maxResults: 10
});

// 以表格形式顯示圖書信息（編輯推薦）
await callTool('format_books_table', {
  type: 'editor_choice',
  maxResults: 10
});

// 以表格形式顯示圖書信息（博主暢銷書）
await callTool('format_books_table', {
  type: 'blogger_best',
  maxResults: 10,
  categoryId: '798'
});

📚 詳細文檔

工具列表

1. search_books

用於搜索圖書。 參數：

• query (string)：搜索詞。
• searchType (enum)：搜索類型（Title、Author、Publisher、Keyword）。
• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。

2. get_book_detail

通過 ISBN 查詢圖書詳細信息。 參數：

• isbn (string)：圖書的 ISBN（10 位或 13 位）。

3. get_bestsellers

查詢圖書暢銷書列表，支持按類別搜索。 參數：

• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。
• categoryId (string, optional)：類別 ID（CID） - 限制特定類別搜索。

4. get_new_books

查詢新書全量列表，支持按類別搜索。 參數：

• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。
• categoryId (string, optional)：類別 ID（CID） - 限制特定類別搜索。

5. get_special_new_books

查詢值得關注的新書列表，支持按類別搜索。 參數：

• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。
• categoryId (string, optional)：類別 ID（CID） - 限制特定類別搜索。

6. get_editor_choice

查詢編輯推薦列表，支持按類別搜索。 參數：

• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。
• categoryId (string, optional)：類別 ID（CID） - 限制特定類別搜索。

7. get_blogger_best

查詢博主暢銷書列表（僅國內圖書），支持按類別搜索。 參數：

• maxResults (number)：最大結果數量（1 - 100，默認值：10）。
• start (number)：搜索起始編號（默認值：1）。
• categoryId (string, optional)：類別 ID（CID） - 限制特定類別搜索。

8. search_categories

搜索圖書類別，優先顯示上級類別。 參數：

• searchTerm (string)：要搜索的類別名稱。
• maxResults (number)：最大結果數量（1 - 50，默認值：20）。

9. get_popular_categories

查詢常用主要類別列表，優先顯示上級類別。 參數：

• limit (number)：要顯示的類別數量（1 - 50，默認值：20）。

10. format_books_table

將圖書信息整理成表格形式顯示，支持搜索、ISBN 查詢和各種圖書列表查詢。 參數：

• type (enum)：查詢類型（search、isbn、bestseller、new_books、special_new_books、editor_choice、blogger_best）。
• query (string, optional)：搜索詞（當 type 為 search 時必填）。
• isbn (string, optional)：ISBN（當 type 為 isbn 時必填）。
• searchType (enum)：搜索類型（Title、Author、Publisher、Keyword，默認值：Title）。
• maxResults (number)：最大結果數量（1 - 50，默認值：10）。
• categoryId (string, optional)：類別 ID（列表查詢時限制類別）。

🔧 技術細節

項目結構

server/
├── src/
│   ├── index.ts                     # 主服務器文件
│   └── aladin_book_categories.json  # 類別信息文件（大容量）
├── dist/                            # 構建結果
├── package.json                     # 包配置
├── tsconfig.json                    # TypeScript 配置
├── env.example                      # 環境變量示例
├── test.js                          # 測試文件
└── README.md                        # 文檔

技術棧

• Node.js：運行時環境。
• TypeScript：類型安全（目標 ES2020，模塊 ESNext）。
• @modelcontextprotocol/sdk：MCP 協議實現。
• axios：HTTP 客戶端。
• zod：模式驗證。

開發依賴

• tsx：TypeScript 開發執行器。
• @types/node：Node.js 類型定義。

構建配置

• 目標：ES2020
• 模塊：ESNext
• 輸出目錄：dist/
• 源映射：包含
• 聲明文件：生成
• JSON 模塊：支持

環境變量

# 阿拉丁 TTB 密鑰（必填）
ALADIN_TTB_KEY=your_aladin_ttb_key_here

📄 許可證

ISC