Show HN: Kiso、オープンナレッジフォーマット向けオープンソースパブリッシングエンジン
Show HN: Kiso, an open-source publishing engine for Open Knowledge Format (oak-invest.github.io)
要約
Kisoは、オープンナレッジフォーマット(OKF)バンドルを人間とAIエージェント向けの静的ウェブサイトに変換するパブリッシングエンジンです。OKFを信頼できる情報源とし、Markdownで知識を編集・管理し、明示的なメタデータとエージェントフレンドリーなHTMLを生成します。GitHub Actionsで自動ビルド・公開も可能です。
全文翻訳
OKF用パブリッシングエンジンおよびMCPサーバー
Open Knowledge Format
Kisoは、Open Knowledge Format (OKF) バンドルを中心に構築された2つのアプリケーションを提供します。kiso-cliはそれらを検証し、静的ウェブサイトとして公開します。一方、kiso-mcp-serverはMCP互換のAIアプリケーションに知識への直接アクセスを提供します。
2つのアプリケーション
OKFバンドルの使用方法を選択
静的パブリッシング
kiso-cli
OKFバンドルをチェックし、人間とAIの両方のために、ナビゲート可能なHTMLページと元のMarkdownファイルを含む静的ウェブサイトを生成します。コマンドラインからローカルで実行するか、GitHub Action内で自動化してください。
AIアクセス
kiso-mcp-server
OKFバンドル上でModel Context Protocolサーバーを起動し、MCP互換のAIがその概念を検索し、Markdownコンテンツを取得できるようにします。AIに接続し、バンドル内の知識で質問に答えさせましょう。
OKFバンドルを静的ウェブサイトとして公開
kiso-cli
コマンドラインアプリケーションは、checkとbuildの2つのコマンドを提供します。checkはOKFバンドルを検証し、buildはその静的ウェブサイトを生成します。ビルド出力は、生成されたHTMLページとともに元のMarkdownファイルを保持します(sitemap.xml、llms.txt、検索エンジン、ダウンロードボタンリンクなどを含む)。
コマンド
checkは何をするか?
checkコマンドは、OKFバンドル内のMarkdownファイルを検証し、公開前にフォーマットまたは構造のエラーを報告します(リンク切れも警告として報告します)。
| source | examples/kb-google-exampleのような任意のOKFバンドルディレクトリ |
コマンド
buildは何をするか?
buildコマンドは、OKFバンドルから静的ウェブサイトを生成します。これには、元のMarkdownファイル、生成されたHTMLページ、sitemap.xml、llms.txt、検索エンジン、およびバンドルダウンロードリンクが含まれます。
| source | examples/kb-google-exampleのような任意のOKFバンドルディレクトリ |
| destination | publicまたは任意の他のディレクトリ |
GitHub Action
GitHub CIでの使用
kiso-cliをGitHub Actionで使用して、OKFバンドルを自動的にチェック、ビルド、およびGitHub Pagesまたはその他の静的ホスティングサービスに公開できます。
- name: Build with Kiso
uses: oak-invest/kiso/applications/kiso-cli-action@v0.2.6
with:
command: build
source: examples/kb-google-example
destination: public/kb-google-example
01
ブラウズ
読者は、ナビゲーションと読みやすいページを備えた構造化された静的ウェブサイトを入手できます。
02
検査
各ページは、レビューや再利用のためにMarkdownソースへのリンクを保持できます。
03
公開
結果はプレーンな静的出力であり、ローカルまたはHTTP経由でホストできます。
MCP経由でAIにOKFへのアクセスを許可
kiso-mcp-server
この2番目のアプリケーションは、OKFバンドル上でModel Context Protocol (MCP) サーバーを起動します。ウェブサイトは生成しません。MCP互換のAIアプリケーションが、バンドルに含まれる知識に直接アクセスできるようにします。
概念の検索
search_concepts MCPツールを使用して、OKFバンドル内の概念を検索します。
概念コンテンツの読み取り
get_concept_content MCPツールを使用して、概念のMarkdownコンテンツを取得します。
kiso-mcp-server \
--source=examples/kb-acme-example-v0.2
MCPクライアント
MCP互換のAIアプリケーションをサーバーエンドポイント(例: http://localhost:8080/mcp)に接続し、利用可能な知識ツールを発見して呼び出せるようにします。