mcpField
F
Folio

Folio

ローカル
jakubro.github.ioメモリ・ナレッジ0今日更新
リポジトリ公式サイト

Folio について

Folio は Markdown とデータファイルのフォルダーをブラウザーでライブ表示し、フォルダー全体を把握するツールを提供します。文書群を扱う人やエージェント向けに、変更追跡、データ表示、整合性検査を組み合わせ、ファイルはプレーンな Markdown のまま保ちます。

主な機能

  1. 01数式、コード、図を含む Markdown の表示
  2. 02ページ内のブロック単位の変更追跡
  3. 03CSV、JSON、Parquet、SQLite データの表示
  4. 04ライブテーブル、チャート、SQL 結果の埋め込み
  5. 05文書内の数値と元データの照合
  6. 06リンク切れやルール違反の検出

活用シーン

  1. 01前回閲覧後のメモの変更確認
  2. 02データファイルの閲覧とレコードの絞り込み
  3. 03文書内の数値とデータの整合性維持
  4. 04CI でフォルダーのリンクや規約を検査

MCP 対応

Folio は MCP サーバーを提供し、ブラウザー表示と同じフォルダーモデルへのエージェントのアクセスを可能にします。エージェントスキルは、そのモデルを使う文書の作成方法も案内します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "jakubro-folio": {
      "command": "npx",
      "args": [
        "-y",
        "@jakubro/folio"
      ]
    }
  }
}
起動コマンドnpx -y @jakubro/folio

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@jakubro/folio0.5.1

ツール

16

掲載時のツール一覧 · 4 日前に更新

パラメーター型必須説明
folderstringいいえ提供されたフォルダーからの相対パス、またはその配下の絶対パス（例：notes/）。省略するとフォルダー全体が対象になります。

詳細

Folio

License: GPL v3 Version Status

Markdown とデータを含むフォルダーをリアルタイムで表示します。 Folio にフォルダーを指定すると、ブラウザーで内容を読めます。すべてのページが GitHub 形式の Markdown、数式、シンタックスハイライト付きコード、図表で表示され、保存した瞬間に最新の内容になります。また、フォルダー全体を把握できるので、まだ読んでいない内容、データと一致しなくなった図表、リンクの参照先、壊れているリンクも確認できます。

数式、シンタックスハイライト付きコード、フローチャートを含むページを表示する Folio。フォルダーのファイルツリーとページのアウトラインに挟まれています

インストールと実行

npx @jakubro/folio ~/notes

表示されたアドレス（http://localhost:8640/）を開きます。そのポートが使用中の場合は、次に空いているポートが使われます。Folio には Node.js 22.18 以降が必要です。npm install --global @jakubro/folio を実行すると、folio としてインストールされます。

Claude Code では、2 つのコマンドで Folio の MCP サーバーとエージェントスキルをプラグインとしてインストールできます。

claude plugin marketplace add jakubro/folio
claude plugin install folio@folio

プラグインのツールは、Claude Code で開いているフォルダーを提供する Folio を読み取ります。別の Folio を指定するには、/config にある Folio の設定で、localhost:8641 などのアドレスまたはソケットを指定します。

Folio の機能

Folio はフォルダー全体のモデルを保持します。

  • 新たに読んだ内容。 Folio は読んだ内容を記録します。ページを開き直すと、その後に追加、変更、削除された各ブロックが示されます。表は行ごと、リストは項目ごと、コードは行ごとに表示され、クリックすれば以前の文面を確認できます。また、ツリーには移動したドキュメントがすべて示されます。
  • データファイルとドキュメント内のデータ。 CSV、JSON、Parquet、SQLite などのデータファイルは、表やツリーとして開けます。各列の分布がヘッダーの下に表示され、フィルターを使うと、そのレコードと残りのレコードを区別する要素を確認できます。ドキュメントには、それらのデータから表、グラフ、単一の値を埋め込んだり、それらを横断する SQL クエリを埋め込んだりできます。データが変わると、それぞれの表示も更新されます。
  • 並べ替えとフィルターに対応した表。 ページに記述した表、データから埋め込んだ表、データファイルから開いた表は、複数の列で並べ替えられます。また、テキスト、完全一致の値、パターン、複数の値をまとめて条件に使ってフィルターできます。条件は and または or で結合されます。ファイルの内容は変更されず、表示状態はページのアドレスに保持されます。
  • データとの整合性を確認する図表。 データから引用した数値を文章にひも付けると、数値とデータが一致しなくなった時点で Folio が警告します。
  • フォルダーの規約と健全性。 ドキュメントの種類やルールを、FOLIO.md にクエリとして宣言できます。健全性ビューと CI の folio check には、壊れたリンク、見つからないインクルード、失敗したクエリ、違反したルールがすべて表示されます。
  • 履歴。 Git が保持するすべてのバージョンを Folio が検出した保存内容と統合し、ブロックごとに比較できます。また、日または週単位のダイジェストも確認できます。
  • エージェントとエディター。 MCP サーバー、JSON API、言語サーバーから、エージェントやエディターは、あなたが読むものと同じモデルを利用できます。また、エージェントスキルによって、エージェントはそのモデルを活用するドキュメントの書き方を学べます。

フォルダーは通常の Markdown のままです。すべてのページは引き続き GitHub で読めます。また、Folio がフォルダーに書き込むのは、FOLIO.md で指定された内容だけです。

言い換えた段落に以前の文面を下に表示して印を付けたページ、削除されたセクションと新しい段落、変更されたすべてのドキュメントに印を付けたツリー

ドキュメント

詳しいドキュメントは jakubro.github.io/folio で公開されています。

  • ガイド - Folio が追加するすべてのビューを画像付きで紹介します
  • リファレンス - すべてのオプション、アドレス、キー、ルール、Folio が読み書きする内容を説明します
  • アーキテクチャ - Folio の内部の仕組みと、その理由を説明します

ライセンス

Copyright (C) 2026 Jakub Roman。GNU GPL v3 に基づいて配布されています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。