Jsr

🚀 @orgsoft/jsr

An MCP server, CLI utility, and TypeScript library for exploring packages across jsr.io.

JSR is a modern JavaScript repository and alternative to NPM, providing rich TypeScript support, modern features, and seamless integration with Deno.

@orgsoft/jsr features semantic search powered by Orama, package download analytics, and an ability to retrieve files and documentation from any package or scope on jsr. This upgrades your development workflows, particularly when using Deno alongside AI coding tools.

✨ Features

• 📊 Package Details: Version info, download trends, and file/docs listing for any JSR packages
• 🔗 Similarity Search: Discover related packages to an existing package or search query
• 🖥️ CLI, MCP, or DIY: Fully featured command - line interface, MCP server, and exported functions

📦 Installation

First, ensure the latest version of Deno is installed.

As an MCP Server

Add to your 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"
      ]
    }
  }
}

⚠️ Important Note

Replace the path/to/your/deno command to the full path to your deno installation for it to work. (Use which deno to find this path)

As a Command - Line Utility

You can use the command line utility without needing to install anything except Deno.

# Discover web frameworks on JSR
deno run jsr:@orgsoft/jsr search "web frameworks"

# Find similar projects to this one 
deno run jsr:@orgsoft/jsr similar @orgsoft/jsr

# Same as above, but with permissions granted ahead of time
deno run --allow-net --allow-run jsr:@orgsoft/jsr similar @orgsoft/jsr

CLI installation

You can also install it permanently with deno install:

# Install with default name of "jsr"
deno install -frAg jsr:@orgsoft/jsr # --name [or - some - other - name]

# Get details of @std/http
jsr details @std/http

# Get documentation of @std/http
jsr docs @std/http

# Activate MCP server
jsr mcp

⚠️ Important Note

Consider using the minimal permissions necessary and specifying pinned version numbers for this package and others, to improve security. You should always review code you execute on your computer and Deno is ideal for this due to its permissions system, open - source programs, & sandboxing model.

⚠️ Important Note

Of note is the --allow-run permission included in these installation instructions. It's only necessary for the MCP server's jsr docs command, solely for running deno doc which is a safe, read - only command. The permission be omitted if the feature is undesired. The MCP server will gracefully handle it by not advertising the docs tool.

💻 Usage Examples

Available MCP tools

MCP parameter reference

MCP usage examples

# Search for web frameworks
search query="web framework" limit=10

# Find packages similar to @std/http  
find_similar packageName="@std/http" limit=6

# Discover machine learning libraries
discover category="machine learning" limit=8

# Compare testing frameworks
compare packages=["@std/testing", "@deno/testing", "@fresh/testing"]

# Browse all packages in @std scope
scope_packages scope="std"

# Get detailed package information
package_details scope="std" packageName="http"

# View download statistics with rolling windows
package_downloads scope="std" packageName="http"

# Retrieve a specific file from a package version
package_file scope="std" packageName="http" version="1.0.0" filePath="mod.ts"

# Get package documentation
docs module="@std/path"

# Check search system status
search_status

CLI usage

The package includes a comprehensive command - line interface for all JSR search and analytics features.

CLI commands

CLI options

CLI examples

# Search for web frameworks
deno run jsr:@orgsoft/jsr search "web framework" --limit 5

# Find packages similar to @std/http
deno run jsr:@orgsoft/jsr similar @std/http --limit 3

# Get detailed information about a package
deno run jsr:@orgsoft/jsr details @std/path

# View download statistics with rolling windows
deno run jsr:@orgsoft/jsr downloads std http

# List all packages in the @std scope
deno run jsr:@orgsoft/jsr scope std

# Get a specific file from a package version
deno run jsr:@orgsoft/jsr file @std/http 1.0.0 mod.ts

# Check if a package exists
deno run jsr:@orgsoft/jsr exists @std/nonexistent

# Enhanced search with better relevance
deno run jsr:@orgsoft/jsr search "http client" --enhanced --limit 10

TypeScript module usage

Basic search

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

// Basic search
const results = await relevanceSearch("web framework", { limit: 10 });
console.log(results.hits.map(hit => hit.document.name));

Package information

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

// Get detailed package info
const packageInfo = await getPackageDetails("std", "http");
console.log(packageInfo);

// Get comprehensive download statistics
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(', ')}`);

Similar package discovery

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}`);
});

🔧 Technical Details

Components

• Orama Cloud Integration: Semantic search via Orama's hosted service, used by JSR.io.
• JSR API Client: Direct integration with JSR's REST APIs for detailed package information.
• MCP Protocol Server: Model Context Protocol server for AI assistants
• String formatting & aggregation: Presentational logic

Files

📚 Documentation

Browse the full TypeScript docs for this package at: jsr:@orgsoft/jsr/doc.

📄 Related links

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