🚀 图书馆搜索 MCP 服务器
本项目是一个基于 Calil API 实现的图书馆搜索用 MCP（模型上下文协议）服务器。借助该服务器，Claude 等 AI 助手能够直接访问日本全国的图书馆信息，为信息获取提供了极大便利。
✨ 主要特性
- 🔍 可按都道府县名精准搜索图书馆信息。
- 📋 能获取图书馆的基本信息，如图书馆名、所在地等。
- 🤖 可作为 AI 助手的实用工具使用。
📦 安装指南
前提条件
- 需获取 Calil API 密钥，可前往 Calil API 仪表盘 获取。
- 需安装 Node.js v16 以上版本。
本地运行
- 安装依赖项：
npm install
- 设置环境变量：
创建
.env文件，并添加以下内容：
CALIL_APPLICATION_KEY=你的CalilAPI密钥
- 项目构建：
npm run build
- 启动服务器：
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：搜索关键字
📚 详细文档
限制事项
- 当前仅实现了图书馆信息的检索功能。
- 图书搜索功能计划在未来的版本中实现。
📄 许可证
本项目采用 MIT 许可证。