rag-memory-epf-mcp 1.0.0

package/dist/src/tools/tool-registry.js

@@ -0,0 +1,185 @@
+import { z } from 'zod';
+import { knowledgeGraphTools } from './knowledge-graph-tools.js';
+import { ragTools } from './rag-tools.js';
+import { graphQueryTools } from './graph-query-tools.js';
+import { migrationTools } from './migration-tools.js';
+// Central registry of all tools
+export const allTools = {
+    ...knowledgeGraphTools,
+    ...ragTools,
+    ...graphQueryTools,
+    ...migrationTools,
+    // Add other tool categories here as needed
+};
+// Global settings for tool descriptions
+export const globalSettings = {
+    version: '1.0.0',
+    systemName: 'RAG Knowledge Graph MCP Server',
+    defaultTimeout: 60,
+};
+/**
+ * Convert a structured ToolDefinition to MCP tool format
+ */
+export function convertToMCPTool(name, toolDef) {
+    // Convert Zod schema to JSON schema properties
+    const properties = {};
+    const required = [];
+    for (const [key, zodType] of Object.entries(toolDef.schema)) {
+        // Extract the JSON schema representation from Zod
+        const jsonSchema = zodTypeToJsonSchema(zodType, key);
+        properties[key] = jsonSchema;
+        // Check if required (not optional)
+        if (!zodType.isOptional?.()) {
+            required.push(key);
+        }
+    }
+    return {
+        name,
+        description: toolDef.description(globalSettings),
+        inputSchema: {
+            type: 'object',
+            properties,
+            required,
+        },
+    };
+}
+/**
+ * Convert Zod type to JSON schema (simplified)
+ */
+function zodTypeToJsonSchema(zodType, fieldName) {
+    // Handle common Zod types
+    if (zodType._def) {
+        const def = zodType._def;
+        switch (def.typeName) {
+            case 'ZodString':
+                return {
+                    type: 'string',
+                    description: def.description || `${fieldName} parameter`,
+                };
+            case 'ZodNumber':
+                return {
+                    type: 'number',
+                    description: def.description || `${fieldName} parameter`,
+                    ...(def.default !== undefined && { default: def.default }),
+                };
+            case 'ZodBoolean':
+                return {
+                    type: 'boolean',
+                    description: def.description || `${fieldName} parameter`,
+                    ...(def.default !== undefined && { default: def.default }),
+                };
+            case 'ZodArray':
+                return {
+                    type: 'array',
+                    description: def.description || `Array of ${fieldName}`,
+                    items: zodTypeToJsonSchema(def.type, `${fieldName} item`),
+                };
+            case 'ZodObject':
+                const objectProperties = {};
+                const objectRequired = [];
+                for (const [key, value] of Object.entries(def.shape())) {
+                    objectProperties[key] = zodTypeToJsonSchema(value, key);
+                    if (!value.isOptional?.()) {
+                        objectRequired.push(key);
+                    }
+                }
+                return {
+                    type: 'object',
+                    description: def.description || `${fieldName} object`,
+                    properties: objectProperties,
+                    required: objectRequired,
+                };
+            case 'ZodRecord':
+                return {
+                    type: 'object',
+                    description: def.description || `${fieldName} record`,
+                    additionalProperties: true,
+                };
+            case 'ZodOptional':
+                const innerSchema = zodTypeToJsonSchema(def.innerType, fieldName);
+                return {
+                    ...innerSchema,
+                    optional: true,
+                };
+            case 'ZodDefault':
+                const defaultSchema = zodTypeToJsonSchema(def.innerType, fieldName);
+                return {
+                    ...defaultSchema,
+                    default: def.defaultValue(),
+                };
+            default:
+                console.warn(`Unknown Zod type: ${def.typeName} for field ${fieldName}`);
+                return {
+                    type: 'string',
+                    description: `${fieldName} parameter (fallback)`,
+                };
+        }
+    }
+    // Fallback for unknown types
+    return {
+        type: 'string',
+        description: `${fieldName} parameter`,
+    };
+}
+/**
+ * Get all tools in MCP format
+ */
+export function getAllMCPTools() {
+    return Object.entries(allTools).map(([name, toolDef]) => convertToMCPTool(name, toolDef));
+}
+/**
+ * Get a specific tool definition by name
+ */
+export function getToolDefinition(name) {
+    return allTools[name];
+}
+/**
+ * Validate tool arguments using Zod schema
+ */
+export function validateToolArgs(toolName, args) {
+    const toolDef = getToolDefinition(toolName);
+    if (!toolDef) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    const schema = z.object(toolDef.schema);
+    return schema.parse(args);
+}
+/**
+ * Get tool names organized by category
+ */
+export function getToolsByCategory() {
+    return {
+        knowledgeGraph: Object.keys(knowledgeGraphTools),
+        rag: Object.keys(ragTools),
+        graphQuery: Object.keys(graphQueryTools),
+        migration: Object.keys(migrationTools),
+        all: Object.keys(allTools),
+    };
+}
+/**
+ * Get comprehensive tool documentation
+ */
+export function getToolDocumentation(toolName) {
+    const toolDef = getToolDefinition(toolName);
+    if (!toolDef) {
+        return `Tool '${toolName}' not found`;
+    }
+    return toolDef.description(globalSettings);
+}
+/**
+ * Get system information and tool summary
+ */
+export function getSystemInfo() {
+    const categories = getToolsByCategory();
+    return {
+        system: globalSettings,
+        toolCounts: {
+            knowledgeGraph: categories.knowledgeGraph.length,
+            rag: categories.rag.length,
+            graphQuery: categories.graphQuery.length,
+            total: categories.all.length,
+        },
+        availableTools: categories,
+    };
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/src/tools/tool-registry.js.map

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

package/dist/src/tools/types.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export interface ToolCapabilityInfo {
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            optional?: boolean;
+            items?: {
+                type: string;
+            };
+            additionalProperties?: boolean;
+            default?: any;
+        }>;
+        required: string[];
+    };
+}
+export type ToolRegistrationDescription = (globalSettings?: any) => string;
+export interface ToolDefinition {
+    capability: ToolCapabilityInfo;
+    description: ToolRegistrationDescription;
+    schema: z.ZodRawShape;
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC;YACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;YAC/B,OAAO,CAAC,EAAE,GAAG,CAAC;SACf,CAAC,CAAC;QACH,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,MAAM,2BAA2B,GAAG,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;AAG3E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,2BAA2B,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;CACvB;AAGD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH"}

package/dist/src/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "rag-memory-epf-mcp",
+  "version": "1.0.0",
+  "description": "Advanced MCP server for RAG-enabled memory with gte-multilingual-base embeddings (768-dim, 70+ languages)",
+  "license": "MIT",
+  "author": "bripin123",
+  "homepage": "https://github.com/heesongkoh/rag-memory-epf-mcp",
+  "bugs": "https://github.com/heesongkoh/rag-memory-epf-mcp/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heesongkoh/rag-memory-epf-mcp.git"
+  },
+  "type": "module",
+  "bin": {
+    "rag-memory-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.5.1",
+    "@modelcontextprotocol/sdk": "1.0.1",
+    "better-sqlite3": "11.9.1",
+    "sqlite-vec": "^0.1.6",
+    "tiktoken": "^1.0.17",
+    "zod": "^3.25.28"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22",
+    "shx": "^0.3.4",
+    "typescript": "^5.6.2"
+  }
+}