Aladin Book Search MCP Server

阿拉丁图书搜索MCP服务器（Node.js）

利用阿拉丁图书搜索API的模型上下文协议（MCP）服务器。

特点

• 图书检索：按标题、作者、出版社、关键词搜索图书
• 详细信息：通过ISBN查询图书详细信息
• 畅销书：查看阿拉丁畅销书列表（支持按类别搜索）
• 搜索类别：搜索和查询图书类别（优先显示上级）

阿拉丁API密钥发放

此MCP服务器需要阿拉丁的API密钥。

1. 阿拉丁TTB网站连接到
2. 注册和登录会员
3. 申请API密钥发放

DXT安装

DXT文件

1. 从克隆桌面选择“设置”-“扩展”
2. 拖放下载的DXT文件
3. 输入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_키"
      }
    }
  }
}

“工具”（Tools）

1.搜索_书籍

搜索图书。

参数：

• query （string）：搜索词
• searchType （枚举）：검색 타입 （标题、作者、出版商、关键字）
• 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.获取新书籍

查看新书完整列表。可以按类别进行搜索。

参数：

• maxResults （number）：最大结果数（1-100，默认值：10）
• start （number）：搜索开始编号（默认值：1）
• categoryId （string，optional）：类别ID（CID）-搜索限制为特定类别

5.获取_特别_新书

查看值得关注的新书列表。可以按类别进行搜索。

参数：

• maxResults （number）：最大结果数（1-100，默认值：10）
• start （number）：搜索开始编号（默认值：1）
• categoryId （string，optional）：类别ID（CID）-搜索限制为特定类别

6.获取编辑选择

查看编辑推荐列表。可以按类别进行搜索。

参数：

• 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.搜索_类别

搜索图书类别。优先显示顶级类别。

参数：

• searchTerm （string）：要搜索的类别名称
• maxResults （number）：最大结果数（1-50，默认值：20）

9.获取_人口_类别

查看常用主要类别列表。优先显示顶级类别。

参数：

• limit （number）：要显示的类别数（1-50，默认值：20）

10.格式_书籍_表格

以表格形式整理并显示图书信息。支持搜索、ISBN查询、各种图书列表查询。

参数：

• type （枚举）：조회 타입 （搜索、isbn、畅销书、新书、专题新书、编辑选择、blogger_best）
• query （string，optional）：查询（如果类型为search，则必须）
• isbn （string，optional）：ISBN（如果类型为isbn，则必须）
• searchType （enum）：搜索类型（Title，Author，Publisher，Keyword，默认值：Title）
• maxResults （number）：最大结果数（1-50，默认值：10）
• categoryId （string，optional）：类别ID（查询列表时限制类别）

使用示例

可在MCP客户端上使用：

// 도서 검색
await callTool('search_books', {
  query: '파이썬',
  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: '파이썬',
  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'
});

开发

项目结构

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模块）
• @模型上下文协议/sdk：实施MCP协议
• 轴：HTTP客户端
• 动物圈：验证方案

开发依赖性

• 多伦多证券交易所：TypeScript开发启动器
• @类型/节点：定义Node.js类型

构建设置

• 目标：ES2020
• 模块：ES下一页
• 输出目录：dist/
• 源映射：包括
• 声明文件：创建
• JSON模块：支持

环境变量

# 알라딘 TTB 키 (필수)
ALADIN_TTB_KEY=your_aladin_ttb_key_here

许可证

这个项目 MIT许可证分发到。