@trace.market/types 0.1.0

package/mcp-server/README.md

@@ -0,0 +1,151 @@
+# Trace Market Types MCP Server
+
+This MCP server provides intelligent type management and data validation for the Trace Market food supply chain platform.
+
+## Features
+
+### For Authenticated Users (Admin/User Role)
+- **Create types from natural language**: Describe a type in plain English and get TypeScript definitions
+- **Add/modify type definitions**: Directly add or update TypeScript type definitions
+- **Track changes**: All type modifications are version controlled
+
+### For All Users (Including Anonymous)
+- **List types**: Browse all available type definitions
+- **Get type details**: View detailed field information for any type
+- **Validate data**: Check if data conforms to type specifications
+- **Query data**: Filter and search based on type structure
+- **Generate reports**: Create custom reports in JSON, Markdown, or HTML
+
+## Installation
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+1. Copy `.env.example` to `.env`
+2. Set `JWT_SECRET` to a secure random string
+3. (Optional) Configure database URL for data persistence
+4. (Optional) Add LLM API keys for better natural language processing
+
+## Authentication
+
+Generate a JWT token for authenticated operations:
+
+```javascript
+const jwt = require('jsonwebtoken');
+const token = jwt.sign(
+  { userId: 'user123', role: 'user' }, // or role: 'admin'
+  'your-jwt-secret',
+  { expiresIn: '24h' }
+);
+```
+
+## MCP Tools
+
+### `list_types`
+List all available type definitions with optional filtering.
+- **Auth required**: No
+- **Parameters**:
+  - `filter` (optional): Search string to filter type names
+
+### `get_type_definition`
+Get detailed definition of a specific type.
+- **Auth required**: No
+- **Parameters**:
+  - `typeName` (required): Name of the type
+
+### `validate_data`
+Validate data against a type definition.
+- **Auth required**: No
+- **Parameters**:
+  - `typeName` (required): Type to validate against
+  - `data` (required): Data object to validate
+
+### `create_type_from_description`
+Generate TypeScript type from natural language description.
+- **Auth required**: Yes (user or admin)
+- **Parameters**:
+  - `description` (required): Natural language description
+  - `authToken` (required): JWT authentication token
+
+### `add_type_definition`
+Add a new type definition to the repository.
+- **Auth required**: Yes (user or admin)
+- **Parameters**:
+  - `typeDefinition` (required): TypeScript code
+  - `authToken` (required): JWT authentication token
+
+### `query_data`
+Query and filter data based on type structure.
+- **Auth required**: No
+- **Parameters**:
+  - `typeName` (required): Type to query
+  - `query` (optional): Query filters
+
+### `generate_report`
+Generate custom reports from type data.
+- **Auth required**: No
+- **Parameters**:
+  - `reportType` (required): 'summary', 'detailed', or 'impact'
+  - `data` (required): Data to include in report
+  - `format` (optional): 'json', 'markdown', or 'html'
+
+## Usage with GitHub Copilot
+
+Add this MCP server to your Copilot configuration:
+
+```json
+{
+  "mcpServers": {
+    "tm-types": {
+      "command": "node",
+      "args": ["/path/to/tm-types/mcp-server/dist/index.js"],
+      "env": {
+        "JWT_SECRET": "your-secret-key"
+      }
+    }
+  }
+}
+```
+
+Then in Copilot, you can:
+- Ask to list all types: "Show me all available types"
+- Create new types: "Create a new type for tracking organic certification with fields for certifier, issue date, and expiry date"
+- Validate data: "Check if this data matches the FoodInstance type"
+- Generate reports: "Create a summary report of this product's carbon footprint"
+
+## Integration with Transcription/Chatbots
+
+The MCP server supports non-authenticated access for data queries and report generation, making it perfect for:
+- Voice-driven data entry (transcription → validation)
+- Chatbot interfaces for supply chain data
+- Public dashboards and reports
+- API integrations
+
+Example chatbot flow:
+1. User speaks: "What's the carbon footprint of this coconut drink?"
+2. Transcription service converts to text
+3. Chatbot queries MCP: `generate_report` with reportType='impact'
+4. MCP returns formatted report
+5. Chatbot presents results to user
+
+## Development
+
+```bash
+# Watch mode
+npm run dev
+
+# Build
+npm run build
+
+# Start server
+npm start
+```
+
+## License
+
+MIT

package/mcp-server/generate-token.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * Generate JWT tokens for authenticated MCP operations
+ * Usage: node generate-token.js [userId] [role]
+ */
+
+import jwt from 'jsonwebtoken';
+import readline from 'readline';
+
+const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key-change-in-production';
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function generateToken(userId, role, expiresIn = '24h') {
+  return jwt.sign(
+    { userId, role },
+    JWT_SECRET,
+    { expiresIn }
+  );
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  
+  if (args.length >= 2) {
+    const [userId, role] = args;
+    const token = generateToken(userId, role);
+    console.log('\nGenerated JWT Token:');
+    console.log(token);
+    console.log('\nDecoded payload:');
+    console.log(jwt.decode(token));
+    process.exit(0);
+  }
+  
+  console.log('=== JWT Token Generator ===\n');
+  
+  rl.question('Enter User ID: ', (userId) => {
+    rl.question('Enter Role (user/admin): ', (role) => {
+      rl.question('Expiration (default: 24h): ', (expiry) => {
+        const expiresIn = expiry || '24h';
+        const token = generateToken(userId, role, expiresIn);
+        
+        console.log('\n=== Generated Token ===');
+        console.log(token);
+        console.log('\n=== Decoded Payload ===');
+        console.log(jwt.decode(token));
+        console.log('\n=== Usage Example ===');
+        console.log('In MCP tool call, include:');
+        console.log(JSON.stringify({ authToken: token }, null, 2));
+        
+        rl.close();
+      });
+    });
+  });
+}
+
+main();