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 许可证。