MCP Server Librarian

🚀 図書管理システム（Librarian）

図書管理システム（Librarian）は、大規模言語モデル（LLM）と連携して使用するための強力な知識管理システムです。このシステムは、ドキュメント管理、タグ管理、LLMとの深度な統合など、様々な機能を提供し、知識の整理と利用を効率化します。

🚀 クイックスタート

このシステムを使い始めるには、以下の手順を参考にしてください。まずは、基本的な機能の使い方を紹介します。

✨ 主な機能

• ドキュメント管理：ドキュメントの取得、一覧表示、検索機能を通じて、保存された知識コンテンツを効果的に管理します。
• タグ管理：知識コンテンツの分類タグを管理および照会することができます。
• 深度な統合：モデルコンテキストプロトコル（Model Context Protocol）を通じて、LLMとシームレスに連携します。

📦 インストール

本プロジェクトのソースコードはGitHubにホストされています。以下のコマンドを使用してクローンしてください。

git clone https://github.com/yourusername/librarian.git

💻 使用例

基本的な使用法

単一ドキュメントの取得

# 指定されたパスのドキュメントを取得する
const document = await mcp.useTool("librarian", "getDocument", {
  filepath: "/daisyui/components/button.md"
});

複数ドキュメントの取得

# 複数のドキュメントを同時に取得する
const documents = await mcp.useTool("librarian", "getDocuments", {
  filepaths: ["/daisyui/components/button.md", "/daisyui/components/card.md"]
});

📚 ドキュメント

ディレクトリ構造

図書管理システムは、以下のディレクトリ構造をサポートしています。

• /daisyui/components：DaisyUIコンポーネントのドキュメントが含まれています。
• /tailwind4：Tailwind CSS v4関連の知識を保存します。
• /tutorial：様々なチュートリアルコンテンツが格納されています。
• /reference：参考資料やAPIドキュメントを保存します。

タグシステム

主要なタグは以下の通りです。

• components：コンポーネント関連の知識
• styles：スタイル設計関連の知識
• tutorials：チュートリアルコンテンツ
• references：参考資料

ドキュメント形式要件

すべてのドキュメントはMarkdown形式で記述する必要があり、ファイルヘッダにメタデータを追加する必要があります。例えば：

---
title: ボタンコンポーネント
description: DaisyUIボタンコンポーネントの詳細な説明
tags:
  - components
  - interactive
  - button
---

統合とLLMとの連携

図書管理システムは、LLMに以下のインターフェースを提供します。

1. タグ発見：利用可能なすべてのタグを一覧表示し、知識分類体系を理解します。
2. ドキュメント発見：利用可能なドキュメントを閲覧し、どのような知識コンテンツがあるかを把握します。
3. 検索：必要に応じて、ドキュメント内で正確な検索を行います。
4. 検索：特定のドキュメントの完全な内容を取得します。
5. コンテキスト構築：検索された内容を利用して、応答生成のための背景情報を提供します。

エラー処理

図書管理システムは、標準的なMCPエラー応答メカニズムを採用しています。具体的には以下の通りです。

• INVALID_ARGUMENT：引数が無効な場合にトリガーされます。
• NOT_FOUND：要求されたドキュメントまたはディレクトリが存在しない場合に返されます。
• INTERNAL：サーバーで予期しないエラーが発生した場合に使用されます。

各エラー応答には、以下の情報が含まれています。

• エラーコード
• 説明情報
• デバッグ用のオプション詳細

よくある問題の解決策

ドキュメントが見つからない場合

1. ファイルパスを確認する：提供されたfilepathまたはfilepaths引数が正しいことを確認してください。
2. ドキュメントの存在を確認する：対象のドキュメントが指定されたディレクトリに実際に存在することを確認してください。
3. アクセス権限を検証する：現在のユーザーが対象のリソースにアクセスする権限を持っていることを確認してください。

タグ関連の問題

1. タグが存在しない場合：入力ミスの可能性があります。スペルを確認し、利用可能なタグのリストを照合してください。
2. タグが多すぎる場合：より具体的または広範なタグを使用してクエリを行うことを検討してください。

📄 ライセンス

本プロジェクトはMITオープンソースライセンスに準拠しています。

コントリビューションガイド

コミュニティからの貢献を歓迎します！開発に参加する方法については、CONTRIBUTING.mdファイルを参照してください。

作者情報

• プロジェクトメンテナ：[Your Name]
• 連絡先メールアドレス：your.email@example.com
• GitHubページ：https://github.com/yourusername

図書管理システムは現在も改善中のツールです。皆様の使用とフィードバックをお待ちしています！