lyrenth-mcp

Lyrenth MCP サーバー

任意の MCP クライアントから、Lyrenth のインデックスを通じてウェブを読み取れます。

3 つのツールを提供します。

• read_url は公開ウェブページを、タイトル、説明、構造を含む、安定した Markdown 形式のクリーンな AIDocument に変換します。ナビゲーションや定型情報は取り除かれます。エージェントは生の HTML の代わりに、トークン数を抑えたクリーンなコンテンツを読み取ることができ、各結果には生のページと比べて節約されたトークン数が表示されます。
• read_urls は、1 回のバッチ呼び出しで最大 20 個の URL に対して同じ処理を行います。
• check_usage は、プランの種類とクレジットの使用状況を報告します。

読み取りには、呼び出し元をまたいで共有される Lyrenth のキャッシュを使用します。また、検証済みドメインでは、発行元の正規版を返します。

各ツールは、4 種類すべての MCP ツールアノテーション（読み取り専用、非破壊的、冪等、オープンワールドまたはクローズドワールド）を明示的なブール値として宣言します。また、HTTP トランスポートには、セキュリティ態勢を網羅する 14 件のテストスイートが付属しています。

ホスト型、インストール不要

MCP クライアントがカスタムヘッダー付きのリモート HTTP サーバーに対応していれば（Claude と Cursor のリモートコネクターは対応しています）、実行するものはありません。

• URL：https://api.lyrenth.com/mcp
• ヘッダー：Authorization: Bearer aiwk_your_key_here

同じ 3 つのツールを同じキーで使えます。以下の npx を使う方法は、stdio 経由で MCP を利用するクライアント向け、およびローカルプロセスを使いたい方向けです。

セットアップ

1. https://lyrenth.com/signup で無料の API キーを取得します（月 2,000 回の読み取り、カード不要）。
2. MCP クライアントにサーバーを追加します。

Claude Desktop（ワンクリック）

最新リリースから lyrenth-mcp.mcpb をダウンロードして開きます。Claude Desktop がサーバーをインストールし、API キーの入力を求めます。編集が必要な設定ファイルはありません。このバンドルには、npm パッケージと同じコードが含まれています。

自分でビルドする場合：./scripts/build-mcpb.sh。

Claude Desktop / Cursor（手動設定）

MCP 設定に追加します（Claude Desktop の場合：claude_desktop_config.json）。

{
  "mcpServers": {
    "lyrenth": {
      "command": "npx",
      "args": ["-y", "lyrenth-mcp"],
      "env": { "LYRENTH_API_KEY": "aiwk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add lyrenth -e LYRENTH_API_KEY=aiwk_your_key_here -- npx -y lyrenth-mcp

続いて、アシスタントにページを読み取るよう依頼します。例：「https://example.com/article を読んで要約してください。」 read_url が呼び出され、クリーンな AIDocument が返されます。

ツール

ツール	引数	戻り値
read_url	url（文字列、必須）、fresh（ブール値、任意）、max_tokens（整数、任意）	ページをクリーンな AIDocument として返します。短い出典情報ヘッダー（トークン数と、生の HTML と比べてどれだけ小さいか）に続いて、Markdown 本文が含まれます。fresh: true を指定すると、キャッシュ済みのコピーではなく新たに取得します。max_tokens を指定すると、本文の長さをコンテキストの予算に合わせて制限し、段落または文の区切りで自然に切り詰めます。
read_urls	urls（文字列 1～20 個の配列、必須）、fresh（ブール値、任意）、max_tokens（整数、任意）	1 回の呼び出しで最大 20 ページを取得し、それぞれをクリーンな AIDocument として返します。URL ごとにエラーを分離するため、失敗した URL は報告されますが、ほかの URL の処理は妨げられません。読み取りに成功した URL ごとに 1 クレジットが課金されます。
check_usage	なし	プランの種類、月間上限に対する使用済みクレジット数、残りのクレジット数、リセット日。

設定

環境変数	必須	デフォルト	備考
LYRENTH_API_KEY	はい	なし	無料キーは https://lyrenth.com/signup で取得できます
LYRENTH_API_URL	いいえ	https://api.lyrenth.com	ステージング環境またはセルフホスト環境用の上書き

Lyrenth を経由して読む理由

• よりクリーンで、低コストです。 URL ごとに安定した AIDocument 形式を使用するため、モデルに生の HTML を渡す場合よりトークン数を大幅に抑えられます。
• 呼び出し元をまたいでキャッシュされます。 多数のエージェントが同じ URL を取得しても、オリジンへのフェッチは最小限に抑えられるため、高速でオリジンにも優しい仕組みです。
• 検証済みの場合は正規版を取得できます。 サイトの所有者が Lyrenth で検証を済ませている場合、所有者が作成したバージョンを取得でき、変更通知によって最新の状態に保たれます。

プライバシー

サーバーが Lyrenth の API（api.lyrenth.com）に送信するのは、読み取りを依頼した URL と、呼び出しの認証および使用量計測に使う API キーの 2 つだけです。ローカルに保持しているページコンテンツも、会話のコンテキストも、テレメトリーも、マシンの外に送信されません。取得したページやアカウントデータの Lyrenth による取り扱いについては、プライバシーポリシーをご確認ください。 https://www.lyrenth.com/privacy.

ライセンス

MIT です。LICENSE をご覧ください。

ローカルビルド

npm install
npm run build
LYRENTH_API_KEY=aiwk_... node dist/index.js   # speaks MCP over stdio

Lyrenth プロジェクトの一部です。AIDocument 形式はオープンな仕様です。詳しくは https://lyrenth.com/llms-full.txt をご覧ください。