parisinnov-mcp 1.0.0

package/README.md

@@ -0,0 +1,50 @@
+# parisinnov-mcp
+
+MCP Server for RAG-powered knowledge base with **GLM-4.7**.
+
+## Quick Start
+
+### Claude Code
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "parisinnov": {
+      "command": "npx",
+      "args": [
+        "parisinnov-mcp",
+        "--access-token", "your_api_key"
+      ]
+    }
+  }
+}
+```
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Cursor
+
+Same config format in Cursor MCP settings.
+
+## That's it!
+
+No installation needed. `npx` handles everything.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search-context` | Search knowledge base with AI answers (GLM-4.7) |
+| `add-knowledge` | Add document to knowledge base |
+| `list-knowledge` | List all documents |
+| `delete-knowledge` | Delete a document |
+
+## Get your API key
+
+Contact the Paris Innov team to get your access token.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,249 @@
+#!/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';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+// ============================================================================
+// Configuration
+// ============================================================================
+const BACKEND_URL = 'https://parisinnovbackend-production.up.railway.app';
+function parseArguments() {
+    const argv = yargs(hideBin(process.argv))
+        .option('access-token', {
+        alias: 't',
+        type: 'string',
+        description: 'API key for backend authentication',
+        demandOption: true
+    })
+        .help()
+        .parseSync();
+    return {
+        accessToken: argv['access-token']
+    };
+}
+// ============================================================================
+// Backend API Client
+// ============================================================================
+class BackendClient {
+    accessToken;
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+    }
+    get headers() {
+        return {
+            'Authorization': `Bearer ${this.accessToken}`,
+            'Content-Type': 'application/json'
+        };
+    }
+    async ask(question) {
+        const response = await axios.post(`${BACKEND_URL}/ask`, { question }, { headers: this.headers, timeout: 60000 });
+        return response.data;
+    }
+    async addDocument(content, title, source) {
+        const response = await axios.post(`${BACKEND_URL}/documents`, { content, title, source }, { headers: this.headers, timeout: 30000 });
+        return response.data;
+    }
+    async listDocuments(limit = 20) {
+        const response = await axios.get(`${BACKEND_URL}/documents?limit=${limit}`, { headers: this.headers, timeout: 30000 });
+        return response.data;
+    }
+    async deleteDocument(id) {
+        const response = await axios.delete(`${BACKEND_URL}/documents/${id}`, { headers: this.headers, timeout: 30000 });
+        return response.data;
+    }
+}
+// ============================================================================
+// MCP Server
+// ============================================================================
+async function startMCPServer() {
+    const args = parseArguments();
+    const backend = new BackendClient(args.accessToken);
+    const server = new Server({
+        name: 'parisinnov-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: { tools: {} },
+    });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: 'search-context',
+                description: 'Search your knowledge base and get AI-powered answers using GLM-4.7.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        question: {
+                            type: 'string',
+                            description: 'Your question or search query'
+                        }
+                    },
+                    required: ['question']
+                }
+            },
+            {
+                name: 'add-knowledge',
+                description: 'Add new content to your knowledge base. It will be vectorized and available for future searches.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        content: {
+                            type: 'string',
+                            description: 'The content to add'
+                        },
+                        title: {
+                            type: 'string',
+                            description: 'Optional title for the content'
+                        },
+                        source: {
+                            type: 'string',
+                            description: 'Optional source identifier (e.g., "slack", "notion", "manual")'
+                        }
+                    },
+                    required: ['content']
+                }
+            },
+            {
+                name: 'list-knowledge',
+                description: 'List documents in your knowledge base',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of documents to return (default: 20)'
+                        }
+                    }
+                }
+            },
+            {
+                name: 'delete-knowledge',
+                description: 'Delete a document from your knowledge base',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: {
+                            type: 'string',
+                            description: 'The document ID to delete'
+                        }
+                    },
+                    required: ['id']
+                }
+            }
+        ]
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: toolArgs } = request.params;
+        try {
+            switch (name) {
+                case 'search-context': {
+                    const { question } = toolArgs;
+                    if (!question || typeof question !== 'string') {
+                        throw new Error('Question is required');
+                    }
+                    const result = await backend.ask(question);
+                    let responseText = result.answer;
+                    if (result.sources.length > 0) {
+                        responseText += '\n\n---\n**Sources:**';
+                        result.sources.forEach((source, i) => {
+                            responseText += `\n${i + 1}. ${source.title || 'Document'} (${(source.similarity * 100).toFixed(0)}%)`;
+                        });
+                    }
+                    responseText += `\n\n_${result.metadata.documents_found} docs | ${result.metadata.processing_time_ms}ms | ${result.metadata.model}_`;
+                    return {
+                        content: [{ type: 'text', text: responseText }]
+                    };
+                }
+                case 'add-knowledge': {
+                    const { content, title, source } = toolArgs;
+                    if (!content || typeof content !== 'string') {
+                        throw new Error('Content is required');
+                    }
+                    const result = await backend.addDocument(content, title, source);
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Document added!\nID: ${result.document.id}\nTitle: ${result.document.title}`
+                            }]
+                    };
+                }
+                case 'list-knowledge': {
+                    const { limit } = toolArgs;
+                    const result = await backend.listDocuments(limit || 20);
+                    if (result.documents.length === 0) {
+                        return {
+                            content: [{ type: 'text', text: 'No documents in knowledge base.' }]
+                        };
+                    }
+                    let text = `**${result.documents.length} document(s):**\n\n`;
+                    result.documents.forEach((doc, i) => {
+                        text += `${i + 1}. **${doc.title}** (ID: \`${doc.id}\`)\n`;
+                        text += `   ${doc.snippet}\n\n`;
+                    });
+                    return {
+                        content: [{ type: 'text', text }]
+                    };
+                }
+                case 'delete-knowledge': {
+                    const { id } = toolArgs;
+                    if (!id) {
+                        throw new Error('Document ID is required');
+                    }
+                    const result = await backend.deleteDocument(id);
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: result.success
+                                    ? `Document ${id} deleted.`
+                                    : `Failed to delete document ${id}.`
+                            }]
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            if (axios.isAxiosError(error)) {
+                if (error.response) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Backend error (${error.response.status}): ${error.response.data?.message || error.message}`
+                            }],
+                        isError: true
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: `Network error: ${message}` }],
+                    isError: true
+                };
+            }
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true
+            };
+        }
+    });
+    // Start server
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Error handlers
+process.on('uncaughtException', (error) => {
+    console.error('Uncaught exception:', error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    console.error('Unhandled rejection:', reason);
+    process.exit(1);
+});
+// Start
+startMCPServer().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "parisinnov-mcp",
+  "version": "1.0.0",
+  "description": "MCP Server with Smart Query Builder (GLM-4.7) for RAG-powered knowledge base",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "parisinnov-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node --esm src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "model-context-protocol", "rag", "ai", "claude", "cursor", "glm", "featherless", "knowledge-base"],
+  "author": "Paris Innov Hackathon Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/martinbon39/parisinnov-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/martinbon39/parisinnov-mcp/issues"
+  },
+  "homepage": "https://github.com/martinbon39/parisinnov-mcp#readme",
+  "files": ["dist/", "README.md"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "axios": "^1.6.0",
+    "yargs": "^17.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/yargs": "^17.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}