Jsr

🚀 @orgsoft/jsr

@orgsoft/jsr 是一個 MCP 服務器、CLI 實用工具和 TypeScript 庫，用於探索 jsr.io 上的軟件包。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(`總下載量: ${downloads.totalDownloads}`);
console.log(`每週平均下載量: ${downloads.weeklyAverage}`);
console.log(`最近每週的下載總量: ${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} - 得分: ${pkg.score}`);
});

🔧 技術細節

組件

• Orama 雲集成：通過 Orama 的託管服務進行語義搜索，JSR.io 使用該服務。
• JSR API 客戶端：直接與 JSR 的 REST API 集成，以獲取詳細的軟件包信息。
• MCP 協議服務器：為 AI 助手提供的模型上下文協議服務器。
• 字符串格式化和聚合：呈現邏輯。

文件

📚 詳細文檔

你可以在 jsr:@orgsoft/jsr/doc 瀏覽該軟件包的完整 TypeScript 文檔。

相關鏈接

• JSR 註冊表
• Orama 雲
• MCP 協議
• Deno 文檔