@yirifi-org/mcp-server 1.2.0

package/dist/tools/filter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Tool filtering and defer loading utility for MCP server.
+ * Allows filtering tools via YIRIFI_TOOLS environment variable.
+ * Supports defer_loading for on-demand tool discovery to reduce token usage.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Extended Tool type that supports defer_loading for on-demand tool discovery.
+ *
+ * When `defer_loading: true`, the tool is excluded from initial context but can
+ * still be discovered by Claude's Tool Search Tool. This reduces token usage
+ * by ~85% while maintaining access to the full tool library.
+ *
+ * @see https://www.anthropic.com/engineering/advanced-tool-use
+ */
+export interface DeferredTool extends Tool {
+    /** When true, tool is excluded from initial context but discoverable on-demand */
+    defer_loading?: boolean;
+}
+/**
+ * Set the tool categories map for filtering.
+ * Called during server startup after tools are generated.
+ */
+export declare function setToolCategories(categories: Record<string, {
+    service: string;
+    category: string;
+}>): void;
+/**
+ * Filter tools based on YIRIFI_TOOLS patterns.
+ *
+ * @param tools - Array of all available tools
+ * @param patternsString - Comma-separated whitelist patterns (from YIRIFI_TOOLS env var)
+ * @returns Filtered array of tools matching at least one pattern
+ *
+ * @example
+ * // Return all tools (no filtering)
+ * filterTools(tools, undefined)
+ *
+ * @example
+ * // Return only RegDB tools
+ * filterTools(tools, "regdb:*")
+ *
+ * @example
+ * // Return specific categories
+ * filterTools(tools, "regdb:countries:*,web3grc:knowledge:*")
+ */
+export declare function filterTools(tools: DeferredTool[], patternsString: string | undefined): DeferredTool[];
+/**
+ * Apply defer_loading flag to tools matching the specified patterns.
+ *
+ * Tools marked with `defer_loading: true` are excluded from initial context
+ * but can still be discovered on-demand by Claude's Tool Search Tool.
+ * This significantly reduces token usage (~85% reduction) while maintaining
+ * full access to the tool library.
+ *
+ * @param tools - Array of tools to process
+ * @param patternsString - Comma-separated patterns for tools to defer (from YIRIFI_DEFER_TOOLS)
+ * @returns Array of tools with defer_loading applied to matching tools
+ *
+ * @example
+ * // Defer all marketplace tools
+ * applyDeferLoading(tools, "web3grc:marketplace:*")
+ *
+ * @example
+ * // Defer multiple categories
+ * applyDeferLoading(tools, "regdb:articles:*,web3grc:common:*")
+ *
+ * @example
+ * // Defer all tools except those explicitly needed
+ * // (combine with YIRIFI_TOOLS to whitelist immediate tools)
+ * applyDeferLoading(tools, "regdb:*,web3grc:*")
+ *
+ * @see https://www.anthropic.com/engineering/advanced-tool-use
+ */
+export declare function applyDeferLoading(tools: DeferredTool[], patternsString: string | undefined): DeferredTool[];
+/**
+ * Get all available tool categories for documentation/help.
+ *
+ * @returns Object with service -> categories mapping
+ */
+export declare function getAvailableCategories(): Record<string, string[]>;
+//# sourceMappingURL=filter.d.ts.map

package/dist/tools/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/tools/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAChE,IAAI,CAEN;AA2DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,YAAY,EAAE,CA8BhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,YAAY,EAAE,CA+BhB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWjE"}

package/dist/tools/filter.js

@@ -0,0 +1,176 @@
+/**
+ * Tool filtering and defer loading utility for MCP server.
+ * Allows filtering tools via YIRIFI_TOOLS environment variable.
+ * Supports defer_loading for on-demand tool discovery to reduce token usage.
+ */
+/**
+ * Tool category mapping - dynamically populated from generated tools.
+ * Set via setToolCategories() during server startup.
+ */
+let TOOL_CATEGORIES = {};
+/**
+ * Set the tool categories map for filtering.
+ * Called during server startup after tools are generated.
+ */
+export function setToolCategories(categories) {
+    TOOL_CATEGORIES = categories;
+}
+/**
+ * Check if a tool name matches a given pattern.
+ *
+ * Supported patterns:
+ * - Service wildcard: "regdb:*" (all tools from regdb service)
+ * - Category wildcard: "web3grc:knowledge:*" (all knowledge tools)
+ * - Exact match: tool name (less common with swagger-based generation)
+ *
+ * @param toolName - The tool name to check
+ * @param pattern - The pattern to match against
+ * @returns true if the tool matches the pattern
+ */
+function matchesPattern(toolName, pattern) {
+    // Exact match
+    if (pattern === toolName) {
+        return true;
+    }
+    // Wildcard patterns use colon separator
+    if (!pattern.includes(":")) {
+        return false;
+    }
+    const parts = pattern.split(":");
+    const toolInfo = TOOL_CATEGORIES[toolName];
+    // Unknown tool - can't match patterns
+    if (!toolInfo) {
+        return false;
+    }
+    // Service wildcard: "regdb:*" or "web3grc:*"
+    if (parts.length === 2 && parts[1] === "*") {
+        return toolInfo.service === parts[0];
+    }
+    // Category wildcard: "regdb:countries:*" or "web3grc:knowledge:*"
+    if (parts.length === 3 && parts[2] === "*") {
+        return toolInfo.service === parts[0] && toolInfo.category === parts[1];
+    }
+    return false;
+}
+/**
+ * Parse comma-separated patterns string into array.
+ *
+ * @param patternsString - Comma-separated patterns (e.g., "regdb:*,web3grc:knowledge:*")
+ * @returns Array of trimmed patterns
+ */
+function parsePatterns(patternsString) {
+    return patternsString
+        .split(",")
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+}
+/**
+ * Filter tools based on YIRIFI_TOOLS patterns.
+ *
+ * @param tools - Array of all available tools
+ * @param patternsString - Comma-separated whitelist patterns (from YIRIFI_TOOLS env var)
+ * @returns Filtered array of tools matching at least one pattern
+ *
+ * @example
+ * // Return all tools (no filtering)
+ * filterTools(tools, undefined)
+ *
+ * @example
+ * // Return only RegDB tools
+ * filterTools(tools, "regdb:*")
+ *
+ * @example
+ * // Return specific categories
+ * filterTools(tools, "regdb:countries:*,web3grc:knowledge:*")
+ */
+export function filterTools(tools, patternsString) {
+    // No filtering if patterns not specified or empty
+    if (!patternsString || patternsString.trim() === "") {
+        return tools;
+    }
+    const patterns = parsePatterns(patternsString);
+    if (patterns.length === 0) {
+        return tools;
+    }
+    const filtered = tools.filter((tool) => patterns.some((pattern) => matchesPattern(tool.name, pattern)));
+    // Log warnings for patterns that didn't match any tools
+    const matchedToolNames = new Set(filtered.map((t) => t.name));
+    for (const pattern of patterns) {
+        // Skip wildcards for this check
+        if (pattern.includes("*")) {
+            continue;
+        }
+        // Check if exact tool name exists
+        if (!matchedToolNames.has(pattern) && !TOOL_CATEGORIES[pattern]) {
+            console.error(`Warning: Unknown tool in YIRIFI_TOOLS: "${pattern}"`);
+        }
+    }
+    return filtered;
+}
+/**
+ * Apply defer_loading flag to tools matching the specified patterns.
+ *
+ * Tools marked with `defer_loading: true` are excluded from initial context
+ * but can still be discovered on-demand by Claude's Tool Search Tool.
+ * This significantly reduces token usage (~85% reduction) while maintaining
+ * full access to the tool library.
+ *
+ * @param tools - Array of tools to process
+ * @param patternsString - Comma-separated patterns for tools to defer (from YIRIFI_DEFER_TOOLS)
+ * @returns Array of tools with defer_loading applied to matching tools
+ *
+ * @example
+ * // Defer all marketplace tools
+ * applyDeferLoading(tools, "web3grc:marketplace:*")
+ *
+ * @example
+ * // Defer multiple categories
+ * applyDeferLoading(tools, "regdb:articles:*,web3grc:common:*")
+ *
+ * @example
+ * // Defer all tools except those explicitly needed
+ * // (combine with YIRIFI_TOOLS to whitelist immediate tools)
+ * applyDeferLoading(tools, "regdb:*,web3grc:*")
+ *
+ * @see https://www.anthropic.com/engineering/advanced-tool-use
+ */
+export function applyDeferLoading(tools, patternsString) {
+    // No defer loading if patterns not specified or empty
+    if (!patternsString || patternsString.trim() === "") {
+        return tools;
+    }
+    const patterns = parsePatterns(patternsString);
+    if (patterns.length === 0) {
+        return tools;
+    }
+    // Count how many tools will be deferred for logging
+    let deferredCount = 0;
+    const result = tools.map((tool) => {
+        const shouldDefer = patterns.some((pattern) => matchesPattern(tool.name, pattern));
+        if (shouldDefer) {
+            deferredCount++;
+            return { ...tool, defer_loading: true };
+        }
+        return tool;
+    });
+    if (deferredCount > 0) {
+        console.error(`Defer loading applied: ${deferredCount}/${tools.length} tools marked for deferred loading`);
+    }
+    return result;
+}
+/**
+ * Get all available tool categories for documentation/help.
+ *
+ * @returns Object with service -> categories mapping
+ */
+export function getAvailableCategories() {
+    const categories = {};
+    for (const { service, category } of Object.values(TOOL_CATEGORIES)) {
+        if (!categories[service]) {
+            categories[service] = new Set();
+        }
+        categories[service].add(category);
+    }
+    return Object.fromEntries(Object.entries(categories).map(([k, v]) => [k, Array.from(v)]));
+}
+//# sourceMappingURL=filter.js.map

package/dist/tools/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/tools/filter.ts"],"names":[],"mappings":"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"}

package/dist/tools/generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OpenAPI-based tool generator.
+ * Fetches swagger specs and generates MCP tools dynamically.
+ *
+ * Tool names are derived from swagger operationId with service prefix:
+ *   operationId: "list_categories" → tool name: "web3grc_list_categories"
+ */
+import { type McpToolDefinition } from "openapi-mcp-generator";
+import type { DeferredTool } from "./filter.js";
+/**
+ * Extended tool definition that includes execution metadata.
+ * Combines DeferredTool properties with generator-specific metadata.
+ */
+export interface GeneratedTool {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description?: string;
+    /** JSON Schema for input parameters */
+    inputSchema: DeferredTool["inputSchema"];
+    /** When true, tool is excluded from initial context */
+    defer_loading?: boolean;
+    /** Original tool definition from openapi-mcp-generator */
+    _meta: McpToolDefinition;
+    /** Category information for filtering */
+    _category?: {
+        service: string;
+        category: string;
+    };
+}
+/**
+ * Build tool categories map for filtering support.
+ */
+export declare function buildToolCategories(tools: GeneratedTool[]): Record<string, {
+    service: string;
+    category: string;
+}>;
+/**
+ * Generate all MCP tools from swagger specifications.
+ *
+ * @param baseUrl - Base URL for the Yirifi API (e.g., https://dev-api.yirifi.ai)
+ * @returns Array of generated tools with execution metadata
+ */
+export declare function generateToolsFromSwagger(baseUrl: string): Promise<GeneratedTool[]>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/tools/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/tools/generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IACzC,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,KAAK,EAAE,iBAAiB,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAqDD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EAAE,GACrB,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAWvD;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA0BxF"}

package/dist/tools/generator.js

@@ -0,0 +1,97 @@
+/**
+ * OpenAPI-based tool generator.
+ * Fetches swagger specs and generates MCP tools dynamically.
+ *
+ * Tool names are derived from swagger operationId with service prefix:
+ *   operationId: "list_categories" → tool name: "web3grc_list_categories"
+ */
+import { getToolsFromOpenApi } from "openapi-mcp-generator";
+const SERVICES = [
+    { name: "web3grc", swaggerPath: "/web3grc/external-swagger-auto.json" },
+    { name: "regdb", swaggerPath: "/regdb/external-swagger-auto.json" },
+];
+/**
+ * Infer category from tool path for filtering support.
+ */
+function inferCategory(pathTemplate, service) {
+    if (service === "regdb") {
+        if (pathTemplate.includes("/country"))
+            return "countries";
+        if (pathTemplate.includes("/articles"))
+            return "articles";
+        if (pathTemplate.includes("/organization"))
+            return "organizations";
+        return "other";
+    }
+    // web3grc
+    if (pathTemplate.includes("/knowledge/"))
+        return "knowledge";
+    if (pathTemplate.includes("/marketplace/"))
+        return "marketplace";
+    if (pathTemplate.includes("/common/"))
+        return "common";
+    return "other";
+}
+/**
+ * Generate tools from a single swagger spec.
+ */
+async function generateToolsFromSpec(baseUrl, config) {
+    const specUrl = `${baseUrl}${config.swaggerPath}`;
+    console.error(`Fetching swagger spec: ${specUrl}`);
+    const mcpTools = await getToolsFromOpenApi(specUrl, {
+        baseUrl,
+        dereference: true,
+    });
+    console.error(`Generated ${mcpTools.length} tools from ${config.name} spec`);
+    return mcpTools.map((tool) => {
+        // Tool name = service prefix + operationId from swagger
+        const name = `${config.name}_${tool.operationId}`;
+        const category = inferCategory(tool.pathTemplate, config.name);
+        return {
+            name,
+            description: tool.description || `${tool.method.toUpperCase()} ${tool.pathTemplate}`,
+            inputSchema: tool.inputSchema,
+            _meta: tool,
+            _category: { service: config.name, category },
+        };
+    });
+}
+/**
+ * Build tool categories map for filtering support.
+ */
+export function buildToolCategories(tools) {
+    const categories = {};
+    for (const tool of tools) {
+        const meta = tool;
+        if (meta._category) {
+            categories[tool.name] = meta._category;
+        }
+    }
+    return categories;
+}
+/**
+ * Generate all MCP tools from swagger specifications.
+ *
+ * @param baseUrl - Base URL for the Yirifi API (e.g., https://dev-api.yirifi.ai)
+ * @returns Array of generated tools with execution metadata
+ */
+export async function generateToolsFromSwagger(baseUrl) {
+    console.error("Generating tools from swagger specifications...");
+    const results = await Promise.all(SERVICES.map((config) => generateToolsFromSpec(baseUrl, config)));
+    const allTools = results.flat();
+    // Check for duplicate tool names
+    const names = new Set();
+    const duplicates = [];
+    for (const tool of allTools) {
+        if (names.has(tool.name)) {
+            duplicates.push(tool.name);
+        }
+        names.add(tool.name);
+    }
+    if (duplicates.length > 0) {
+        console.error(`Warning: Duplicate tool names detected: ${duplicates.join(", ")}`);
+    }
+    console.error(`Total tools generated: ${allTools.length}`);
+    return allTools;
+}
+//# sourceMappingURL=generator.js.map

package/dist/tools/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/tools/generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA0B,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAWpF,MAAM,QAAQ,GAAoB;IAChC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE;IACvE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mCAAmC,EAAE;CACpE,CAAC;AAqBF;;GAEG;AACH,SAAS,aAAa,CAAC,YAAoB,EAAE,OAA4B;IACvE,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,OAAO,WAAW,CAAC;QAC1D,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,UAAU,CAAC;QAC1D,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;YAAE,OAAO,eAAe,CAAC;QACnE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU;IACV,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,WAAW,CAAC;IAC7D,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,aAAa,CAAC;IACjE,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAe,EACf,MAAqB;IAErB,MAAM,OAAO,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAElD,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE;QAClD,OAAO;QACP,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,eAAe,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC;IAE7E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,wDAAwD;QACxD,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAE/D,OAAO;YACL,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE;YACpF,WAAW,EAAE,IAAI,CAAC,WAA0C;YAC5D,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE;SAC7B,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsB;IAEtB,MAAM,UAAU,GAA0D,EAAE,CAAC;IAE7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAA6E,CAAC;QAC3F,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAe;IAC5D,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CACjE,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEhC,iCAAiC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,2CAA2C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+	"name": "@yirifi-org/mcp-server",
+	"version": "1.2.0",
+	"description": "MCP server for Yirifi GRC Platform external APIs",
+	"type": "module",
+	"main": "dist/index.js",
+	"bin": {
+		"yirifi-mcp": "dist/index.js"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/yirifi/yirifi-external-api-mcp.git"
+	},
+	"homepage": "https://github.com/yirifi/yirifi-external-api-mcp#readme",
+	"bugs": {
+		"url": "https://github.com/yirifi/yirifi-external-api-mcp/issues"
+	},
+	"scripts": {
+		"prepare": "npm run build",
+		"dev": "tsx watch src/server-stdio.ts",
+		"dev:http": "tsx watch src/server-http.ts",
+		"build": "tsc",
+		"start": "node dist/server-stdio.js",
+		"start:http": "node dist/server-http.js",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"format": "biome format --write .",
+		"test": "vitest"
+	},
+	"keywords": [
+		"mcp",
+		"yirifi",
+		"grc",
+		"compliance",
+		"regulations"
+	],
+	"author": "Yirifi Team",
+	"license": "MIT",
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.25.0",
+		"axios": "^1.7.9",
+		"dotenv": "^16.4.7",
+		"express": "^5.2.1",
+		"openapi-mcp-generator": "^3.2.0",
+		"zod": "^3.24.1",
+		"zod-to-json-schema": "^3.24.1"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/express": "^5.0.6",
+		"@types/node": "^22.10.2",
+		"tsx": "^4.19.2",
+		"typescript": "^5.7.2",
+		"vitest": "^2.1.8"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	}
+}