brief-mcp 1.0.0

package/README.md

@@ -0,0 +1,79 @@
+# parisinnov-mcp
+
+MCP Server for **Paris Innov** knowledge base powered by **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_MCP_TOKEN"
+      ]
+    }
+  }
+}
+```
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Cursor
+
+Same config format in Cursor MCP settings.
+
+## That's it!
+
+No backend needed. The MCP connects directly to Supabase Edge Functions.
+
+## Get your MCP Token
+
+1. Sign up at Paris Innov
+2. Join an organization
+3. Copy your MCP token from your profile
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search-context` | Search knowledge base with AI answers (GLM-4.7) |
+| `add-knowledge` | Add document (auto-chunked & vectorized) |
+| `list-knowledge` | List all documents |
+| `delete-knowledge` | Delete a document |
+
+## Architecture
+
+```
+Claude Code / Cursor
+       │
+       ▼
+┌──────────────────────────┐
+│   parisinnov-mcp (npm)   │
+└──────────┬───────────────┘
+           │ Direct HTTPS
+           ▼
+┌──────────────────────────┐
+│  Supabase Edge Functions │
+│  • search-context        │
+│  • ingest-context        │
+│  • list-documents        │
+│  • delete-document       │
+└──────────┬───────────────┘
+           │
+           ▼
+┌──────────────────────────┐
+│  Supabase PostgreSQL     │
+│  • pgvector embeddings   │
+│  • Multi-tenant (orgs)   │
+└──────────────────────────┘
+```
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,268 @@
+#!/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 - Direct Supabase Edge Functions
+// ============================================================================
+const SUPABASE_URL = 'https://pubrvnwqeimnoxgdeage.supabase.co';
+const EDGE_FUNCTIONS_URL = `${SUPABASE_URL}/functions/v1`;
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InB1YnJ2bndxZWltbm94Z2RlYWdlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3Njg2MjU3MTQsImV4cCI6MjA4NDIwMTcxNH0.LdMqYS0quwLdSXkTKEJyYCghSRzrYNNSCkv-tUtGUy4';
+function parseArguments() {
+    const argv = yargs(hideBin(process.argv))
+        .option('access-token', {
+        alias: 't',
+        type: 'string',
+        description: 'Your MCP token for authentication',
+        demandOption: true
+    })
+        .help()
+        .parseSync();
+    return {
+        mcpToken: argv['access-token']
+    };
+}
+// ============================================================================
+// Supabase Edge Functions Client
+// ============================================================================
+class SupabaseClient {
+    mcpToken;
+    constructor(mcpToken) {
+        this.mcpToken = mcpToken;
+    }
+    get headers() {
+        return {
+            'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+            'apikey': SUPABASE_ANON_KEY,
+            'x-mcp-token': this.mcpToken,
+            'Content-Type': 'application/json'
+        };
+    }
+    async search(question) {
+        const response = await axios.post(`${EDGE_FUNCTIONS_URL}/search-context`, { question, match_count: 5, match_threshold: 0.3 }, { headers: this.headers });
+        return response.data;
+    }
+    async ingestDocument(content, title, orgId) {
+        // First get user's org_id from a simple call
+        const response = await axios.post(`${EDGE_FUNCTIONS_URL}/ingest-context`, {
+            content,
+            title: title || 'Untitled',
+            org_id: orgId,
+            source_type: 'mcp'
+        }, { headers: this.headers });
+        return response.data;
+    }
+    async listDocuments(limit = 20) {
+        const response = await axios.get(`${EDGE_FUNCTIONS_URL}/list-documents?limit=${limit}`, { headers: this.headers });
+        return response.data;
+    }
+    async deleteDocument(documentId) {
+        const response = await axios.post(`${EDGE_FUNCTIONS_URL}/delete-document`, { document_id: documentId }, { headers: this.headers });
+        return response.data;
+    }
+}
+// ============================================================================
+// MCP Server
+// ============================================================================
+async function startMCPServer() {
+    const args = parseArguments();
+    const supabase = new SupabaseClient(args.mcpToken);
+    // Cache org_id after first call
+    let cachedOrgId = null;
+    const server = new Server({
+        name: 'parisinnov-mcp',
+        version: '1.1.0',
+    }, {
+        capabilities: { tools: {} },
+    });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: 'search-context',
+                description: 'Search your organization\'s 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 organization\'s knowledge base. Content is automatically chunked and vectorized.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        content: {
+                            type: 'string',
+                            description: 'The content to add (supports markdown)'
+                        },
+                        title: {
+                            type: 'string',
+                            description: 'Title for the document'
+                        }
+                    },
+                    required: ['content']
+                }
+            },
+            {
+                name: 'list-knowledge',
+                description: 'List documents in your organization\'s 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 organization\'s 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 supabase.search(question);
+                    let responseText = result.answer;
+                    if (result.sources && result.sources.length > 0) {
+                        responseText += '\n\n---\n**Sources:**';
+                        result.sources.forEach((source, i) => {
+                            responseText += `\n${i + 1}. ${source.title} (${(source.similarity * 100).toFixed(0)}%)`;
+                        });
+                    }
+                    responseText += `\n\n_${result.metadata.documents_found} chunks | ${result.metadata.processing_time_ms}ms | ${result.metadata.model}_`;
+                    return {
+                        content: [{ type: 'text', text: responseText }]
+                    };
+                }
+                case 'add-knowledge': {
+                    const { content, title } = toolArgs;
+                    if (!content || typeof content !== 'string') {
+                        throw new Error('Content is required');
+                    }
+                    // Get org_id from list-documents if not cached
+                    if (!cachedOrgId) {
+                        const listResult = await supabase.listDocuments(1);
+                        cachedOrgId = listResult.org_id;
+                    }
+                    const result = await supabase.ingestDocument(content, title, cachedOrgId);
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Document added!\nID: ${result.documentId}\nChunks created: ${result.chunks}`
+                            }]
+                    };
+                }
+                case 'list-knowledge': {
+                    const { limit } = toolArgs;
+                    const result = await supabase.listDocuments(limit || 20);
+                    cachedOrgId = result.org_id; // Cache for future add-knowledge calls
+                    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 supabase.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)) {
+                const status = error.response?.status;
+                const errorMsg = error.response?.data?.error || error.message;
+                if (status === 401) {
+                    return {
+                        content: [{ type: 'text', text: 'Invalid MCP token. Check your access-token.' }],
+                        isError: true
+                    };
+                }
+                if (status === 400) {
+                    return {
+                        content: [{ type: 'text', text: `Bad request: ${errorMsg}` }],
+                        isError: true
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: `Error (${status}): ${errorMsg}` }],
+                    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": "brief-mcp",
+  "version": "1.0.0",
+  "description": "Brief MCP - Context-first development with RAG-powered knowledge base",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "brief-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": "Brief Team - Paris Innov Hackathon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marlowetal653/innovhack.git"
+  },
+  "bugs": {
+    "url": "https://github.com/marlowetal653/innovhack/issues"
+  },
+  "homepage": "https://github.com/marlowetal653/innovhack#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"
+  }
+}