mcp-rgek 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# MCP RGEK - Knowledge Base Server
+
+MCP Server for accessing RGEK Knowledge Base.
+
+## Installation
+
+```bash
+npm install -g mcp-rgek
+```
+
+## Configuration
+
+Set environment variables:
+```bash
+export RGEK_API_URL="http://your-api-url:8000"
+export RGEK_API_USER="your-username"
+```
+
+## Usage
+
+Add to your MCP client configuration:
+```json
+{
+  "mcpServers": {
+    "rgek": {
+      "command": "mcp-rgek"
+    }
+  }
+}
+```
+
+## Tools
+
+- `search_articles`: Search articles by query with optional filters
+- `get_article`: Get specific article by ID  
+- `list_categories`: List available areas and tags

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import axios from 'axios';
+const API_BASE_URL = process.env.RGEK_API_URL || 'http://localhost:8181/base';
+const API_USER = process.env.RGEK_API_USER;
+class RGEKServer {
+    server;
+    constructor() {
+        this.server = new Server({
+            name: 'mcp-rgek',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupToolHandlers();
+    }
+    setupToolHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'search_articles',
+                    description: 'Search for information in the RGEK knowledge base. Use this when the user asks for specific information, documentation, procedures, or knowledge that might be stored in the company knowledge base.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            keywords: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Keywords extracted from user query to search for relevant information (max 5)',
+                                maxItems: 5,
+                            },
+                            areas: {
+                                type: 'array',
+                                items: { type: 'number' },
+                                description: 'Optional area IDs to filter by',
+                            },
+                            tags: {
+                                type: 'array',
+                                items: { type: 'number' },
+                                description: 'Optional tag IDs to filter by',
+                            },
+                            page: {
+                                type: 'number',
+                                description: 'Page number (default: 1)',
+                                default: 1,
+                            },
+                            per_page: {
+                                type: 'number',
+                                description: 'Items per page (default: 10)',
+                                default: 10,
+                            },
+                        },
+                        required: ['keywords'],
+                    },
+                },
+                {
+                    name: 'get_article',
+                    description: 'Get a specific article by ID',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'number',
+                                description: 'Article ID',
+                            },
+                        },
+                        required: ['id'],
+                    },
+                },
+                {
+                    name: 'list_categories',
+                    description: 'List available areas and tags',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+            ],
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'search_articles':
+                        return await this.searchArticles(args);
+                    case 'get_article':
+                        return await this.getArticle(args);
+                    case 'list_categories':
+                        return await this.listCategories();
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    async getToken() {
+        if (!API_USER) {
+            throw new Error('RGEK_API_USER not configured');
+        }
+        const response = await axios.post(`${API_BASE_URL}/security/token/`, {
+            usuario: API_USER
+        }, {
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        return response.data.resultado.respuesta.token;
+    }
+    async makeRequest(endpoint, params) {
+        const token = await this.getToken();
+        const response = await axios.get(`${API_BASE_URL}${endpoint}`, {
+            headers: {
+                'Authorization': `Bearer ${token}`
+            },
+            params,
+        });
+        return response.data;
+    }
+    async searchArticles(args) {
+        const { keywords, areas, tags, page = 1, per_page = 10 } = args;
+        const token = await this.getToken();
+        const searches = keywords.slice(0, 5).map((keyword) => axios.post(`${API_BASE_URL}/conocimiento/buscar/combinado`, {
+            keyword,
+            areas: areas || [],
+            tags: tags || [],
+        }, {
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json'
+            },
+            params: { page: 1, per_page: 20 },
+        }));
+        const responses = await Promise.all(searches);
+        const allArticles = new Map();
+        let totalResults = 0;
+        responses.forEach(response => {
+            const data = response.data.resultado.respuesta;
+            totalResults += data.total;
+            data.data.forEach((article) => {
+                if (!allArticles.has(article.id)) {
+                    allArticles.set(article.id, article);
+                }
+            });
+        });
+        const uniqueArticles = Array.from(allArticles.values())
+            .slice((page - 1) * per_page, page * per_page);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        keywords_used: keywords,
+                        articles: uniqueArticles,
+                        total: allArticles.size,
+                        total_searches: totalResults,
+                        page,
+                        per_page,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async getArticle(args) {
+        const { id } = args;
+        const token = await this.getToken();
+        const response = await axios.get(`${API_BASE_URL}/conocimiento/articulo/${id}`, {
+            headers: {
+                'Authorization': `Bearer ${token}`
+            }
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(response.data.resultado.respuesta, null, 2),
+                },
+            ],
+        };
+    }
+    async listCategories() {
+        const token = await this.getToken();
+        const [areasResponse, tagsResponse] = await Promise.all([
+            axios.get(`${API_BASE_URL}/conocimiento/areas`, {
+                headers: { 'Authorization': `Bearer ${token}` },
+                params: { page: 1, per_page: 100 }
+            }),
+            axios.get(`${API_BASE_URL}/conocimiento/tags`, {
+                headers: { 'Authorization': `Bearer ${token}` },
+                params: { page: 1, per_page: 100 }
+            }),
+        ]);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        areas: areasResponse.data.resultado.respuesta.data,
+                        tags: tagsResponse.data.resultado.respuesta.data,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('RGEK MCP server running on stdio');
+    }
+}
+const server = new RGEKServer();
+server.run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "mcp-rgek",
+  "version": "1.0.0",
+  "description": "MCP Server for RGEK Knowledge Base",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mcp-rgek": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.6.0",
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}