HN 日本語サマリー

← 一覧へ戻る
オープンソース

Show HN: Kiso、オープンナレッジフォーマット向けオープンソースパブリッシングエンジン

Show HN: Kiso, an open-source publishing engine for Open Knowledge Format (oak-invest.github.io)

10 pointsby straumat0 コメント

要約

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内で自動化してください。

Kiso CLI を発見

AIアクセス
kiso-mcp-server

OKFバンドル上でModel Context Protocolサーバーを起動し、MCP互換のAIがその概念を検索し、Markdownコンテンツを取得できるようにします。AIに接続し、バンドル内の知識で質問に答えさせましょう。

Kiso MCP Server を発見

OKFバンドルを静的ウェブサイトとして公開

kiso-cli

コマンドラインアプリケーションは、checkとbuildの2つのコマンドを提供します。checkはOKFバンドルを検証し、buildはその静的ウェブサイトを生成します。ビルド出力は、生成されたHTMLページとともに元のMarkdownファイルを保持します(sitemap.xml、llms.txt、検索エンジン、ダウンロードボタンリンクなどを含む)。

コマンド
checkは何をするか?

checkコマンドは、OKFバンドル内のMarkdownファイルを検証し、公開前にフォーマットまたは構造のエラーを報告します(リンク切れも警告として報告します)。

sourceexamples/kb-google-exampleのような任意のOKFバンドルディレクトリ
コマンド
buildは何をするか?

buildコマンドは、OKFバンドルから静的ウェブサイトを生成します。これには、元のMarkdownファイル、生成されたHTMLページ、sitemap.xml、llms.txt、検索エンジン、およびバンドルダウンロードリンクが含まれます。

sourceexamples/kb-google-exampleのような任意のOKFバンドルディレクトリ
destinationpublicまたは任意の他のディレクトリ
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)に接続し、利用可能な知識ツールを発見して呼び出せるようにします。