@toolsdk.ai/registry 1.0.113 → 1.0.115

package/dist/shared/utils/package-util.js

@@ -0,0 +1,53 @@
+import fs from "node:fs";
+import path from "node:path";
+export function updatePackageJsonDependencies({ packageDeps, enableValidation = false, packagesListPath, }) {
+    var _a;
+    const packageJsonFile = "./package.json";
+    const packageJSONStr = fs.readFileSync(packageJsonFile, "utf-8");
+    const newDeps = {
+        "@daytonaio/sdk": "0.109.0",
+        "@e2b/code-interpreter": "^2.0.0",
+        "@modelcontextprotocol/sdk": "^1.12.0",
+        "@hono/node-server": "1.15.0",
+        "@hono/swagger-ui": "^0.5.2",
+        "@hono/zod-openapi": "^0.16.4",
+        "@iarna/toml": "^2.2.5",
+        meilisearch: "^0.33.0",
+        lodash: "^4.17.21",
+        zod: "^3.23.30",
+        axios: "^1.9.0",
+        hono: "4.8.3",
+        sandock: "^0.2.2",
+        semver: "^7.5.4",
+    };
+    if (enableValidation && packagesListPath) {
+        const packagesListStr = fs.readFileSync(packagesListPath, "utf-8");
+        const packagesList = JSON.parse(packagesListStr);
+        for (const [depName, depVer] of Object.entries(packageDeps)) {
+            if ((_a = packagesList[depName]) === null || _a === void 0 ? void 0 : _a.validated) {
+                newDeps[depName] = depVer || "latest";
+            }
+        }
+    }
+    else {
+        Object.assign(newDeps, packageDeps);
+    }
+    const packageJSON = JSON.parse(packageJSONStr);
+    packageJSON.dependencies = newDeps;
+    fs.writeFileSync(packageJsonFile, JSON.stringify(packageJSON, null, 2), "utf-8");
+    console.log(`Generated new package.json file at ${packageJsonFile}`);
+}
+export function getActualVersion(packageName, configuredVersion) {
+    if (configuredVersion && configuredVersion !== "latest") {
+        return configuredVersion;
+    }
+    try {
+        const packageJsonPath = path.join(process.cwd(), "node_modules", packageName, "package.json");
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        return packageJson.version;
+    }
+    catch (e) {
+        console.warn(`Failed to read version for ${packageName}, using 'latest' by default`, e.message);
+        return "latest";
+    }
+}

package/dist/shared/utils/promise-util.d.ts

@@ -0,0 +1 @@
+export declare function withTimeout<T>(ms: number, promise: Promise<T>): Promise<T>;

package/dist/shared/utils/promise-util.js

@@ -0,0 +1,14 @@
+export function withTimeout(ms, promise) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Operation timed out after ${ms}ms`));
+        }, ms);
+        promise.then((res) => {
+            clearTimeout(timer);
+            resolve(res);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}

package/dist/{utils.d.ts → shared/utils/response-util.d.ts}

@@ -1,6 +1,10 @@
 import type { z } from "@hono/zod-openapi";
-import type { Response } from "./types";
-export declare function getDirname(metaUrl: string): string;
+export interface Response<T> {
+    success: boolean;
+    code: number;
+    message: string;
+    data?: T;
+}
 export declare const createResponse: <T>(data: T, options?: {
     success?: boolean;
     code?: number;

package/dist/{utils.js → shared/utils/response-util.js}

@@ -1,9 +1,4 @@
-import { dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { ErrorResponseSchema } from "./schema";
-export function getDirname(metaUrl) {
-    return dirname(fileURLToPath(metaUrl));
-}
+import { ErrorResponseSchema } from "../schemas";
 export const createResponse = (data, options) => {
     const { success = true, code = 200, message = "Success" } = options || {};
     return {

package/dist/shared/utils/string-util.d.ts

@@ -0,0 +1 @@
+export declare function extractLastOuterJSON(str: string): string;

package/dist/shared/utils/string-util.js

@@ -0,0 +1,25 @@
+export function extractLastOuterJSON(str) {
+    let braceCount = 0;
+    let end = -1;
+    let start = -1;
+    for (let i = str.length - 1; i >= 0; i--) {
+        const ch = str[i];
+        if (ch === "}") {
+            if (end === -1)
+                end = i;
+            braceCount++;
+        }
+        else if (ch === "{") {
+            braceCount--;
+            if (braceCount === 0 && end !== -1) {
+                start = i;
+                break;
+            }
+        }
+    }
+    if (start === -1 || end === -1) {
+        throw new Error("No valid JSON found in string");
+    }
+    const jsonStr = str.slice(start, end + 1);
+    return jsonStr;
+}

package/dist/shared/utils/validation-util.d.ts

@@ -0,0 +1,12 @@
+interface PyProjectToml {
+    project?: {
+        dependencies?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function isValidNpmPackage(packageName: string): Promise<boolean>;
+export declare function parsePyprojectToml(): PyProjectToml;
+export declare function extractPackageName(dep: string): string;
+export declare function getPythonDependencies(): string[];
+export {};

package/dist/shared/utils/validation-util.js

@@ -0,0 +1,99 @@
+import fs from "node:fs";
+import toml from "@iarna/toml";
+import axios from "axios";
+import semver from "semver";
+function checkDependencyValidity(dependencyData, versionRange) {
+    if (versionRange === "latest") {
+        return Object.keys(dependencyData.versions).length > 0;
+    }
+    const versions = Object.keys(dependencyData.versions);
+    for (const version of versions) {
+        if (semver.satisfies(version, versionRange)) {
+            return true;
+        }
+    }
+    return false;
+}
+async function checkDependencies(dependencies) {
+    const dependencyCache = {};
+    const checkSingleDependency = async (depName, depVersionRange) => {
+        const cacheKey = `${depName}@${depVersionRange}`;
+        if (dependencyCache[cacheKey] !== undefined) {
+            return dependencyCache[cacheKey];
+        }
+        try {
+            const depResponse = await axios.get(`https://registry.npmjs.org/${depName}`, {
+                timeout: 5000,
+                headers: {
+                    "User-Agent": "MyToolManager/1.0",
+                },
+            });
+            if (depResponse.status !== 200 || !depResponse.data.versions) {
+                console.error(`Failed to fetch ${depName}`);
+                dependencyCache[cacheKey] = false;
+                return false;
+            }
+            const isValid = checkDependencyValidity(depResponse.data, depVersionRange);
+            dependencyCache[cacheKey] = isValid;
+            if (!isValid) {
+                console.error(`Invalid or missing: ${depName}`);
+            }
+            return isValid;
+        }
+        catch (error) {
+            console.error(`Error fetching ${depName}: ${error.message}`);
+            dependencyCache[cacheKey] = false;
+            return false;
+        }
+    };
+    const promises = Object.entries(dependencies).map(([depName, depVersionRange]) => checkSingleDependency(depName, depVersionRange));
+    const results = await Promise.all(promises);
+    return results.every((result) => result);
+}
+export async function isValidNpmPackage(packageName) {
+    var _a, _b, _c, _d;
+    try {
+        console.log("Checking package:", packageName);
+        const response = await axios.get(`https://registry.npmjs.org/${packageName}`, {
+            timeout: 5000,
+            headers: {
+                "User-Agent": "MyToolManager/1.0",
+            },
+        });
+        if (response.status !== 200 || !((_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a["dist-tags"]) === null || _b === void 0 ? void 0 : _b.latest)) {
+            console.error(`Package marked as unpublished: ${packageName}`);
+            return false;
+        }
+        const latestVersion = response.data["dist-tags"].latest;
+        const versionData = (_d = (_c = response.data) === null || _c === void 0 ? void 0 : _c.versions) === null || _d === void 0 ? void 0 : _d[latestVersion];
+        if (!versionData) {
+            console.error(`Invalid package: ${packageName} - No version data found`);
+            return false;
+        }
+        console.log(`Checking dependencies for ${packageName}`);
+        const dependencies = Object.assign(Object.assign({}, versionData.dependencies), versionData.devDependencies);
+        if (!(await checkDependencies(dependencies))) {
+            return false;
+        }
+        console.log(`Valid package: ${packageName}`);
+        return true;
+    }
+    catch (error) {
+        console.error(`Error validating package ${packageName}:`, error.message);
+        return false;
+    }
+}
+export function parsePyprojectToml() {
+    const pyprojectPath = "./python-mcp/pyproject.toml";
+    const content = fs.readFileSync(pyprojectPath, "utf-8");
+    return toml.parse(content);
+}
+export function extractPackageName(dep) {
+    return dep.split(/[=<>!]/)[0].trim();
+}
+export function getPythonDependencies() {
+    var _a;
+    const data = parsePyprojectToml();
+    const deps = ((_a = data.project) === null || _a === void 0 ? void 0 : _a.dependencies) || [];
+    return deps.map(extractPackageName);
+}

package/indexes/categories-list.json

@@ -1685,6 +1685,7 @@
       "@fiveohhwon/workflows-mcp",
       "autodocument",
       "gdb-debugger",
+      "@juspay/neurolink",
       "clojars-dependency-versions",
       "react-analyzer",
       "ansible",

package/indexes/packages-list.json

@@ -47440,5 +47440,11 @@
     "path": "data-platforms/google-analytics.json",
     "validated": false,
     "tools": {}
+  },
+  "@juspay/neurolink": {
+    "category": "developer-tools",
+    "path": "developer-tools/neurolink.json",
+    "validated": false,
+    "tools": {}
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolsdk.ai/registry",
-  "version": "1.0.113",
+  "version": "1.0.115",
   "description": "An Open, Structured, and Standard Registry for MCP Servers and Packages.",
   "keywords": [],
   "license": "MIT",
@@ -31,7 +31,10 @@
     "sort": "sort-package-json",
     "start": "NODE_ENV=production tsx src/api/index.ts",
     "test": "vitest run",
-    "test:search": "vitest run src/search/search.test.ts"
+    "test:coverage": "vitest run --coverage",
+    "test:package": "vitest run src/domains/package",
+    "test:ui": "vitest --ui",
+    "test:watch": "vitest watch"
   },
   "dependencies": {
     "@0xbeedao/mcp-taskwarrior": "1.0.0",
@@ -87,6 +90,7 @@
     "@cyanheads/pubmed-mcp-server": "1.2.3",
     "@cyanheads/toolkit-mcp-server": "1.0.1",
     "@dasheck0/face-generator": "1.0.1",
+    "@daytonaio/sdk": "0.109.0",
     "@debugg-ai/debugg-ai-mcp": "1.0.15",
     "@delorenj/mcp-server-ticketmaster": "0.2.5",
     "@deventerprisesoftware/scrapi-mcp": "0.0.3",
@@ -572,6 +576,7 @@
     "replicate-flux-mcp": "0.1.2",
     "resend-mcp": "0.1.2",
     "rss-reader-mcp": "1.0.3",
+    "sandock": "^0.2.2",
     "scrapeless-mcp-server": "0.3.0",
     "scraperis-mcp": "0.1.22",
     "search-stock-news-mcp": "1.0.12",
@@ -638,6 +643,8 @@
     "@types/lodash": "^4.17.17",
     "@types/node": "^22.15.21",
     "@types/semver": "^7.5.8",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
     "dotenv": "^17.2.1",
     "globals": "^16.2.0",
     "lefthook": "1.7.14",

package/packages/developer-tools/neurolink.json

@@ -0,0 +1,23 @@
+{
+  "type": "mcp-server",
+  "name": "Neurolink",
+  "packageName": "@juspay/neurolink",
+  "description": "Universal AI development platform unifying 12+ providers (OpenAI, Anthropic, Google, Bedrock, Azure) with built-in MCP support, multi-provider failover, and production-ready enterprise features",
+  "url": "https://github.com/juspay/neurolink",
+  "runtime": "node",
+  "license": "Apache-2.0",
+  "env": {
+    "ANTHROPIC_API_KEY": {
+      "description": "API key for Anthropic Claude models",
+      "required": false
+    },
+    "OPENAI_API_KEY": {
+      "description": "API key for OpenAI models",
+      "required": false
+    },
+    "GOOGLE_API_KEY": {
+      "description": "API key for Google Gemini models",
+      "required": false
+    }
+  }
+}

package/packages/search-data-extraction/ref-tools-mcp.json

@@ -4,7 +4,12 @@
   "description": "Integrates with Ref.tools documentation search service to provide curated technical documentation access, web search fallback, and URL-to-markdown conversion for efficient developer reference during coding workflows.",
   "url": "https://github.com/ref-tools/ref-tools-mcp",
   "runtime": "node",
-  "license": "unknown",
-  "env": {},
+  "license": "mit",
+  "env": {
+    "REF_API_KEY": {
+      "description": "sign up to get an API key",
+      "required": true
+    }
+  },
   "name": "Ref Tools MCP"
 }

package/README.dev.md

@@ -1,195 +0,0 @@
-# Awesome MCP Registry Developer Guide
-
-This document provides developers with detailed information on how to set up, run, and develop the Awesome MCP Registry project.
-
-- [Awesome MCP Registry Developer Guide](#awesome-mcp-registry-developer-guide)
-  - [1. 🧰 Prerequisites](#1--prerequisites)
-  - [2. 🧰 Tech Stack](#2--tech-stack)
-  - [3. 🎯 Project Purpose](#3--project-purpose)
-  - [4. 🚀 Quick Start](#4--quick-start)
-    - [4.1 Install Dependencies](#41-install-dependencies)
-    - [4.2 Build Project](#42-build-project)
-    - [4.3 Start Development Server (Without Search Function)](#43-start-development-server-without-search-function)
-    - [4.4 Start Development Server (With Search Function)](#44-start-development-server-with-search-function)
-  - [5. 🐳 Docker Usage](#5--docker-usage)
-    - [5.1 Running with Docker (Without Search Function)](#51-running-with-docker-without-search-function)
-    - [5.2 Running with Docker (With Search Function)](#52-running-with-docker-with-search-function)
-  - [6. 🛠 Common Issues and Troubleshooting](#6--common-issues-and-troubleshooting)
-    - [6.1 MCP Client Test Errors During Build Process](#61-mcp-client-test-errors-during-build-process)
-  - [7. 🗃️ Project Structure](#7-️-project-structure)
-  - [8. ⚙️ Environment Variables](#8-️-environment-variables)
-  - [9. 📝 Contribution Guide](#9--contribution-guide)
-
-## 1. 🧰 Prerequisites
-
-Before you begin, ensure your development environment meets the following requirements:
-
-- **Node.js** >= 18.x (latest LTS version recommended)
-- **pnpm** >= 8.x (package manager)
-- **Docker** (optional, required only if search functionality is needed)
-
-## 2. 🧰 Tech Stack
-
-- **Runtime Environment**: Node.js (ESM modules)
-- **Package Manager**: pnpm
-- **Language**: TypeScript
-- **Web Framework**: Hono.js
-- **Search Service**: MeiliSearch (optional)
-- **Build Tool**: TypeScript Compiler (tsc)
-- **Code Formatting**: Biome
-- **Testing**: Vitest
-
-## 3. 🎯 Project Purpose
-
-This project has two main purposes:
-
-1. **MCP Registry** - Collects and indexes various MCP servers, providing search functionality
-2. **MCP Server** - Deployed as a server to remotely call various MCP servers
-
-Additionally, we have deployed a website [ToolSDK.ai](https://toolsdk.ai) that can search for and run MCP Servers. We also provide a tool called `toolsdk` to help integrate these MCP Servers.
-
-## 4. 🚀 Quick Start
-
-### 4.1 Install Dependencies
-
-```bash
-pnpm install
-```
-
-### 4.2 Build Project
-
-```bash
-make build
-```
-
-This will perform the following operations:
-- Validate all MCP server configurations
-- Install all necessary dependencies
-- Build TypeScript code
-
-### 4.3 Start Development Server (Without Search Function)
-
-This is the simplest way to start, suitable for scenarios where only API functionality is needed:
-
-1. Ensure `ENABLE_SEARCH=false` is set in the `.env` file:
-
-```env
-ENABLE_SEARCH=false
-MCP_SERVER_PORT=3003
-```
-
-2. Start the development server:
-
-```bash
-make dev
-```
-
-3. Access the following endpoints:
-   - API Documentation: http://localhost:3003/swagger
-
-### 4.4 Start Development Server (With Search Function)
-
-If you need full search functionality:
-
-1. Set up the `.env` file:
-
-```env
-ENABLE_SEARCH=true
-MCP_SERVER_PORT=3003
-MEILI_HTTP_ADDR=http://localhost:7700
-```
-
-2. Start the MeiliSearch service:
-
-```bash
-make db
-```
-
-3. Build the project and start the development server:
-
-```bash
-make build
-make dev
-```
-
-4. Initialize search indexes:
-
-Call the following endpoints via API:
-- `POST /api/v1/search/manage/init` - Initialize search service
-- `POST /api/v1/search/manage/index` - Index data
-
-5. Access:
-   - Search Page: http://localhost:3003
-   - API Documentation: http://localhost:3003/swagger
-
-## 5. 🐳 Docker Usage
-
-### 5.1 Running with Docker (Without Search Function)
-
-```bash
-# Build image
-make docker-build
-
-# Run container (ensure ENABLE_SEARCH=false)
-make docker-run
-
-# Visit http://localhost:3003
-```
-
-### 5.2 Running with Docker (With Search Function)
-
-```bash
-# Set ENABLE_SEARCH=true in .env
-# Start MeiliSearch
-make db
-
-# Build and run the main application
-make docker-build
-make docker-run
-
-# Visit http://localhost:3003 to use search functionality and API interfaces
-```
-
-## 6. 🛠 Common Issues and Troubleshooting
-
-### 6.1 MCP Client Test Errors During Build Process
-
-When executing the `make build` command, you may see error messages similar to the following:
-
-```
-Error reading MCP Client for package: claude-prompts... ENOENT: no such file or directory
-```
-
-**This is normal!** The reason for these errors is:
-
-- This project includes thousands of MCP packages
-- The build process attempts to test all packages through the [test-mcp-clients.ts](file:///root/vika/awesome-mcp-registry/scripts/test-mcp-clients.ts) script
-- Due to the large number, the testing process may take several hours
-- Not all packages need to be installed and tested, as most packages are not essential for running the registry
-
-**These errors can be ignored as long as the build process continues to execute.** After the build is complete, you can still use the API and search functionality (if search is enabled) normally.
-
-## 7. 🗃️ Project Structure
-
-```
-.
-├── config/     # Configuration files
-├── indexes/    # Generated index files
-├── packages/   # MCP server configuration files (categorized)
-├── scripts/    # Build and maintenance scripts
-└── src/        # Source code
-    ├── api/    # API routes and server entry points
-    └── search/ # Search service
-```
-
-## 8. ⚙️ Environment Variables
-
-The project uses the following environment variables, which can be configured in `.env` or `.env.local`:
-
-- `MCP_SERVER_PORT`: Server port (default: 3003)
-- `ENABLE_SEARCH`: Whether to enable search service (default: false)
-- `MEILI_HTTP_ADDR`: MeiliSearch service address (default: http://localhost:7700)
-
-## 9. 📝 Contribution Guide
-
-For detailed information on how to contribute code to the project, add new MCP servers, etc., please refer to the [CONTRIBUTING.md](./CONTRIBUTING.md) file.

package/dist/api/package-handler.d.ts

@@ -1,18 +0,0 @@
-import type { Context } from "hono";
-export declare const packageHandler: {
-    executeTool: (c: Context) => Promise<globalThis.Response & import("hono").TypedResponse<{
-        success: boolean;
-        code: number;
-        message: string;
-    }, 200, "json">>;
-    getPackageDetail: (c: Context) => Promise<globalThis.Response & import("hono").TypedResponse<{
-        success: boolean;
-        code: number;
-        message: string;
-    }, 200, "json">>;
-    listTools: (c: Context) => Promise<globalThis.Response & import("hono").TypedResponse<{
-        success: boolean;
-        code: number;
-        message: string;
-    }, 200, "json">>;
-};

package/dist/api/package-handler.js

@@ -1,72 +0,0 @@
-import { createErrorResponse, createResponse } from "../utils";
-import { PackageSO } from "./package-so";
-const shouldUseSandbox = () => {
-    return process.env.USE_MCP_SANDBOX === "true";
-};
-export const packageHandler = {
-    executeTool: async (c) => {
-        const requestBody = await c.req.json();
-        try {
-            const toolSO = new PackageSO(shouldUseSandbox());
-            const result = await toolSO.executeTool(requestBody);
-            const response = createResponse(result);
-            return c.json(response, 200);
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                if (error.message.includes("not found")) {
-                    const errorResponse = createErrorResponse(`Package '${requestBody.packageName}' not found`, 404);
-                    return c.json(errorResponse, 200);
-                }
-                if (error.message.includes("Unknown tool")) {
-                    const errorResponse = createErrorResponse(`Tool '${requestBody.toolKey}' not found in package '${requestBody.packageName}`, 404);
-                    return c.json(errorResponse, 200);
-                }
-                const errorResponse = createErrorResponse(`[executeTool] Error executing tool: ${error.message}`, 500);
-                return c.json(errorResponse, 200);
-            }
-            // Other errors are still thrown
-            throw error;
-        }
-    },
-    getPackageDetail: async (c) => {
-        const packageName = c.req.query("packageName");
-        if (!packageName) {
-            const errorResponse = createErrorResponse("Missing packageName query parameter", 400);
-            return c.json(errorResponse, 200);
-        }
-        try {
-            const toolSO = new PackageSO(shouldUseSandbox());
-            const result = await toolSO.getPackageDetail(packageName);
-            const response = createResponse(result);
-            return c.json(response, 200);
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.includes("not found")) {
-                const errorResponse = createErrorResponse(`Package '${packageName}' not found`, 404);
-                return c.json(errorResponse, 200);
-            }
-            throw error;
-        }
-    },
-    listTools: async (c) => {
-        const packageName = c.req.query("packageName");
-        if (!packageName) {
-            const errorResponse = createErrorResponse("Missing packageName query parameter", 400);
-            return c.json(errorResponse, 200);
-        }
-        try {
-            const toolSO = new PackageSO(shouldUseSandbox());
-            const result = await toolSO.listTools(packageName);
-            const response = createResponse(result);
-            return c.json(response, 200);
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.includes("not found")) {
-                const errorResponse = createErrorResponse(`Package '${packageName}' not found`, 404);
-                return c.json(errorResponse, 200);
-            }
-            throw error;
-        }
-    },
-};

package/dist/api/package-route.d.ts

@@ -1,2 +0,0 @@
-import { OpenAPIHono } from "@hono/zod-openapi";
-export declare const packageRoutes: OpenAPIHono;

package/dist/api/package-so.d.ts

@@ -1,19 +0,0 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { MCPSandboxClient } from "../sandbox/mcp-sandbox-client.js";
-import type { MCPServerPackageConfig, ToolExecute } from "../types";
-export declare class PackageSO {
-    private useSandbox;
-    private sandboxClient;
-    private static sandboxInstances;
-    private static MAX_SANDBOXES;
-    private static IDLE_CLOSE_MS;
-    constructor(useSandbox?: boolean);
-    static acquireSandbox(key?: string): Promise<MCPSandboxClient>;
-    static releaseSandbox(key?: string): Promise<void>;
-    static cleanupSandboxInstances(): Promise<void>;
-    executeTool(request: ToolExecute): Promise<unknown>;
-    private executeToolInSandbox;
-    listTools(packageName: string): Promise<Tool[]>;
-    private listToolsInSandbox;
-    getPackageDetail(packageName: string): Promise<MCPServerPackageConfig>;
-}