MCP Aladin Books Server

🚀 アラジン書籍検索MCPサーバ (Node.js)

アラジン書籍検索APIを活用したMCP(Model Context Protocol)サーバです。このサーバを利用することで、書籍の検索や詳細情報の取得、ベストセラーリストの閲覧などが可能です。

🚀 クイックスタート

このMCPサーバを使用するには、まずアラジンのAPIキーを取得する必要があります。その後、DXTファイルのインストールとサーバの設定を行います。

✨ 主な機能

• 書籍検索：タイトル、著者、出版社、キーワードで書籍を検索できます。
• 詳細情報：ISBNを使って書籍の詳細情報を取得できます。
• ベストセラー：アラジンのベストセラーリストを閲覧でき、カテゴリ別の検索もサポートしています。
• カテゴリ検索：書籍のカテゴリを検索し、上位レベルのカテゴリを優先して表示します。

📦 インストール

アラジンAPIキーの取得

このMCPサーバを使用するには、アラジンのAPIキーが必要です。以下の手順で取得してください。

1. アラジンTTBサイトにアクセスします。
2. 会員登録とログインを行います。
3. APIキーの発行申請を行います。

DXTファイルのインストール

DXTファイルをダウンロードして、以下の手順でインストールします。

1. クラウドデスクトップで[設定] - [拡張機能]を選択します。
2. ダウンロードしたDXTファイルをドラッグアンドドロップします。
3. APIキーを入力します。

依存関係のインストールとビルド

npm install
npm run build

MCPクライアントへの情報入力

{
  "mcpServers": {
    "aladin-books": {
      "command": "node",
      "args": [
        "<パス>/mcp-aladin-books-server/dist/index.js"
      ],
      "env": {
        "ALADIN_TTB_KEY": "アラジン_TTB_キー"
      }
    }
  }
}

💻 使用例

基本的な使用法

// 書籍検索
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