library-mcp

library-mcpは、Markdown ナレッジベースとやり取りするための MCP サーバーです。基本的には、サブフォルダーがある場合もない場合もあるフォルダーで、.md 拡張子のファイルが含まれ、次のようなメタデータで始まります。

----
title: My blog post
tags:
- python
- programming
url: /my-blog-post
---

# My blog post
Yesterday I was dreaming about...

現在のバージョンでの一般的なワークフローは、特定のタグに関連する最近のコンテンツを取得し、そのタグを使って議論することです。

Get the next 50 posts with tag "executive",
then tell me what I should do about this problem
I am running into: ...

日付の範囲を指定して、同じことを行うこともできます。

Summarize the blog posts I wrote in the past year.

「ブログ全体をコンテキストウィンドウにアップロードすればいいのでは？」と思うかもしれません。このライブラリがその方法より優れている点は2つあります。

1. 私のブログのコーパスは、現在のほとんどのモデルのコンテキストウィンドウよりはるかに大きいです。 さらに、コンテキストウィンドウが十分に大きくなったとしても、過去に書いた内容の多くは平凡なので、省略することが利点になるかもしれません。
2. 私は複数の異なる Markdown ナレッジベースを持っており、このライブラリを使うとそれらをまとめて操作できます。

最後に、これは趣味のプロジェクトであり、ノートパソコン上でローカルに実行することを想定しています。このソフトウェアを使って人が被害を受けたことはありませんが、かなりうまく動作します！

ツール

この MCP サーバーは、次のツールを公開します。

コンテンツ検索ツール

コンテンツをコンテキストウィンドウに取得するためのツールです。

• get_by_tag - タグでコンテンツを取得します
• get_by_text - 特定のテキストを含むコンテンツを検索します
• get_by_slug_or_url - スラッグまたは URL で投稿を検索します
• get_by_date_range - 指定した日付範囲内に公開された投稿を取得します

タグ管理ツール

ナレッジベースを閲覧するためのツールです。

• search_tags - クエリに一致するタグを検索します
• list_all_tags - 投稿数と新しさの順に並べたすべてのタグを一覧表示します

メンテナンスツール

ツールの実行に関するツールです。

• rebuild - コンテンツインデックスを再構築します。 コンテンツを追加した場合や、既存のコンテンツを編集した場合などに便利です。

セットアップ／インストール

ここでは、OS X の Claude Desktop へのインストール方法を説明します。 他のプラットフォームでも同様に動作するはずです。

1. Claude Desktopをインストールします。

2. library-mcpを使いやすい場所にクローンします。ここでは /Users/will/library-mcp とします。

3. uv がインストールされていることを確認します。こちらの手順に従ってください。

4. Claude Desktop の「Setting」「Developer」に移動し、MCP 設定ファイルを作成します。 次に、claude_desktop_config.json を更新します。 （will はユーザー名に置き換えてください。たとえば、whoami の出力を使います。）

    cd /Users/will/Library/Application Support/Claude
    vi claude_desktop_config.json
   

   次のセクションを追加します。

    {
      "mcpServers": {
        "library": {
          "command": "uv",
          "args": [
            "--directory",
            "/Users/will/library-mcp",
            "run",
            "main.py",
            "/Users/will/irrational_hugo/content"
          ]
        }
      }
    }
   

5. Claude を終了して、再度開きます。

6. 動作するはずです...