Jsr

🚀 @orgsoft/jsr

jsr.io 全体のパッケージを探索するためのMCPサーバー、CLIユーティリティ、およびTypeScriptライブラリです。

JSRは、最新のJavaScriptリポジトリであり、NPMの代替手段です。豊富なTypeScriptサポート、最新の機能、およびDenoとのシームレスな統合を提供します。

@orgsoft/jsr は、Oramaによるセマンティック検索、パッケージのダウンロード分析、および jsr 上の任意のパッケージまたはスコープからファイルとドキュメントを取得する機能を備えています。これにより、特にDenoとAIコーディングツールを併用する場合の開発ワークフローが向上します。

✨ 主な機能

• 📊 パッケージ詳細：任意のJSRパッケージのバージョン情報、ダウンロードトレンド、およびファイル/ドキュメントのリスト
• 🔗 類似性検索：既存のパッケージまたは検索クエリに関連するパッケージを発見
• 🖥️ CLI、MCP、または自作：充実したコマンドラインインターフェイス、MCPサーバー、およびエクスポートされた関数

📦 インストール

まず、Deno の最新バージョンがインストールされていることを確認してください。

MCPサーバーとして

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "jsr": {
      "command": "path/to/your/deno",
      "args": [
        "run",
        "--allow-net=jsr.io,api.jsr.io,cloud.orama.run",
        "--allow-run",
        "jsr:@orgsoft/jsr@^1",
        "mcp"
      ]
    }
  }
}

⚠️ 重要提示

動作させるには、path/to/your/deno コマンドをDenoのインストール先の完全パスに置き換えてください。（which deno を使用してこのパスを見つけることができます）

コマンドラインユーティリティとして

Deno 以外の何もインストールする必要なく、コマンドラインユーティリティを使用できます。

# JSR上のWebフレームワークを探索
deno run jsr:@orgsoft/jsr search "web frameworks"

# このプロジェクトに類似したプロジェクトを見つける
deno run jsr:@orgsoft/jsr similar @orgsoft/jsr

# 上記と同じですが、事前にパーミッションを付与しています
deno run --allow-net --allow-run jsr:@orgsoft/jsr similar @orgsoft/jsr

CLIのインストール

deno install で恒久的にインストールすることもできます。

# デフォルトの名前 "jsr" でインストール
deno install -frAg jsr:@orgsoft/jsr # --name [or-some-other-name]

# @std/http の詳細を取得
jsr details @std/http

# @std/http のドキュメントを取得
jsr docs @std/http

# MCPサーバーを起動
jsr mcp

セキュリティに関する注意

このパッケージや他のパッケージについて、必要最小限のパーミッション を使用し、固定バージョン番号を指定 することを検討してください。コンピューター上で実行するコードは常にレビューする必要があり、Denoはそのパーミッションシステム、オープンソースプログラム、およびサンドボックスモデルにより、この点で理想的です。

これらのインストール手順に含まれる --allow-run パーミッション に注意してください。これは、MCPサーバーのjsr docs コマンドでのみ必要で、安全な読み取り専用コマンドである deno doc を実行するために使用されます。この機能が不要な場合は、このパーミッションを省略できます。MCPサーバーは、ドキュメントツールを宣伝しないことで適切に対応します。

💻 使用例

利用可能なMCPツール

MCPパラメータ参照

MCP使用例

# Webフレームワークを検索
search query="web framework" limit=10

# @std/http に類似したパッケージを見つける
find_similar packageName="@std/http" limit=6

# 機械学習ライブラリを発見
discover category="machine learning" limit=8

# テストフレームワークを比較
compare packages=["@std/testing", "@deno/testing", "@fresh/testing"]

# @std スコープ内のすべてのパッケージを閲覧
scope_packages scope="std"

# 詳細なパッケージ情報を取得
package_details scope="std" packageName="http"

# ローリングウィンドウでダウンロード統計を表示
package_downloads scope="std" packageName="http"

# パッケージの特定のファイルを取得
package_file scope="std" packageName="http" version="1.0.0" filePath="mod.ts"

# パッケージのドキュメントを取得
docs module="@std/path"

# 検索システムの状態を確認
search_status

CLIの使用

このパッケージには、JSRのすべての検索および分析機能に対応した充実したコマンドラインインターフェイスが含まれています。

CLIコマンド

CLIオプション

CLI使用例

# Webフレームワークを検索
deno run jsr:@orgsoft/jsr search "web framework" --limit 5

# @std/http に類似したパッケージを見つける
deno run jsr:@orgsoft/jsr similar @std/http --limit 3

# パッケージの詳細情報を取得
deno run jsr:@orgsoft/jsr details @std/path

# ローリングウィンドウでダウンロード統計を表示
deno run jsr:@orgsoft/jsr downloads std http

# @std スコープ内のすべてのパッケージをリストする
deno run jsr:@orgsoft/jsr scope std

# パッケージの特定のファイルを取得
deno run jsr:@orgsoft/jsr file @std/http 1.0.0 mod.ts

# パッケージが存在するかどうかを確認
deno run jsr:@orgsoft/jsr exists @std/nonexistent

# 関連性の高い強化検索
deno run jsr:@orgsoft/jsr search "http client" --enhanced --limit 10

TypeScriptモジュールの使用

基本的な検索

import { relevanceSearch } from "jsr:@orgsoft/jsr";

// 基本的な検索
const results = await relevanceSearch("web framework", { limit: 10 });
console.log(results.hits.map(hit => hit.document.name));

パッケージ情報

import { getPackageDetails, getPackageDownloadSummary } from "jsr:@orgsoft/jsr";

// 詳細なパッケージ情報を取得
const packageInfo = await getPackageDetails("std", "http");
console.log(packageInfo);

// 包括的なダウンロード統計を取得
const downloads = await getPackageDownloadSummary("std", "http");
console.log(`Total downloads: ${downloads.totalDownloads}`);
console.log(`Weekly average: ${downloads.weeklyAverage}`);
console.log(`Recent weekly totals: ${downloads.weeklySums.join(', ')}`);

類似パッケージの発見

import { findSimilarPackages } from "jsr:@orgsoft/jsr"

const similar = await findSimilarPackages("@std/http", { limit: 5 });
similar.forEach(pkg => {
  console.log(`${pkg.document.scope}/${pkg.document.name} - Score: ${pkg.score}`);
});

🔧 技術詳細

コンポーネント

• Orama Cloud統合：JSR.ioで使用されるOramaのホストサービスを介したセマンティック検索
• JSR APIクライアント：詳細なパッケージ情報のためのJSRのREST APIとの直接統合
• MCPプロトコルサーバー：AIアシスタント用のモデルコンテキストプロトコルサーバー
• 文字列フォーマットと集約：表示ロジック

ファイル

📚 ドキュメント

このパッケージの完全なTypeScriptドキュメントを以下で閲覧できます。jsr:@orgsoft/jsr/doc

関連リンク

• JSR Registry
• Orama Cloud
• MCP Protocol
• Deno Documentation