图书馆搜索服务

一个基于Calil API的MCP服务器,使AI助手能够访问日本全国图书馆信息。

  • by kzk-maeda
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 kzk-maeda/mcp-book-search

使用说明

图书馆检索MCP 服务器

Calil API 图书馆ー利用MCP (Model Context Protocol) 服务器。通过使用此服务器Claude 等的AI助手可以直接访问日本全国的图书馆信息。

机能

  • 从省/自治区名称搜索图书馆信息
  • 获取图书馆名、所在地等基本信息
  • AI助手可用作工具

使用方法

前提条件

  • API校准キーの取得 (https://calil.jp/api/dashboard/)
  • Node.js v16以上

本地运行

  1. 安装相关性:
npm install
  1. 设置环境变量: .env创建文件并添加以下内容:
CALIL_APPLICATION_KEY=あなたのCalilAPIキー
  1. 项目构建:
npm run build
  1. 启动服务器:
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 连接到
  • 获取图书馆信息
  • 处理工具调用

可用工具

这个MCP服务器提供以下工具:

get_libraries_by_prefecture

搜索指定都道府县内的图书馆信息。

引数:

  • prefecture:都道府県名(例:「东京都」「大阪府」)

返回值: 都道府县内的图书馆系统和图书馆信息的列表

search_books

(现在安装占位符)检索书籍。

引数:

  • query:搜索关键字

制限事项

  • 现在只实施图书馆信息的检索
  • 书籍检索功能将在将来的版本中实施

许可证

麻省理工学院