Skip to main content
Glama

Library Search

search_libraries

図書館名や地域で図書館を検索して蔵書検索に必要なシステムIDを取得します。応答単位はシステムで複数の図書館が一つのシステムに含まれます。利用者が登録した学校図書館も返します。

このAPIキーで蔵書検索できるのは、search_books の説明にある図書館だけです。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo取得件数(省略時10)
keywordNoキーワード

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
countNo検索結果件数
noticeNo利用者に伝える案内(APIキーの期限や今月の残り回数)
reasonNo失敗時の理由
successNo成功したか
librariesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

アノテーションが openWorldHint=true(外部データ参照)と destructiveHint=false を既に示している。説明は『応答単位はシステムで複数の図書館が一つに含まれる』『利用者登録の学校図書館も返す』という返却特性を追加しており付加価値があるが、認証・レート制限や readOnlyHint=false との整合には触れていない。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

目的が冒頭に置かれ、システム単位の返却や APIキー制約といった重要情報が簡潔に続く。無駄な文は少ないが、キー制約の一文は構成上やや唐突で、もう少し統合できる余地がある。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

出力スキーマが存在するため戻り値の説明は不要で、説明は『システム単位でまとまる』という重要な解釈上の注意を提供している。2パラメータ・低複雑度のツールとして必要な情報はほぼ揃っている。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

スキーマ記述カバレッジが100%のため、limit と keyword の意味はスキーマ側で完結している。説明は『図書館名や地域で検索』と keyword の用途を暗示するが、構文や形式の追加情報はなく、ベースライン3が妥当。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

明確に動詞(検索)+リソース(図書館)を述べ、目的(蔵書検索に必要なシステムIDの取得)まで示している。search_books との関係にも触れており、兄弟ツールとの区別は概ね可能だが、get_ndc_info との違いには触れていない。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

『蔵書検索に必要なシステムIDを取得する』という後続用途(search_books)を暗示しており、利用シーンは推測できる。しかし、いつ search_libraries を search_books の代わりに使うべきか、除外条件や前提は明示されていない。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources