myceliumail-mcp 1.0.0

package/README.md

@@ -0,0 +1,143 @@
+# 🍄 Myceliumail MCP Server
+
+> **Connect Myceliumail to Claude Desktop and other MCP clients**
+
+<img src="assets/icon.png" alt="Myceliumail" width="128" />
+
+## Quick Start
+
+### 1. Build the MCP Server
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+### 2. Configure Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "myceliumail": {
+      "command": "node",
+      "args": ["/Users/YOUR_USERNAME/Dev/myceliumail/mcp-server/dist/server.js"],
+      "env": {
+        "MYCELIUMAIL_AGENT_ID": "claude-desktop"
+      }
+    }
+  }
+}
+```
+
+**Important:** Replace `/Users/YOUR_USERNAME/Dev/myceliumail` with your actual path.
+
+### 3. Restart Claude Desktop
+
+Quit and reopen Claude Desktop. You should see "myceliumail" in the MCP tools.
+
+---
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `check_inbox` | View incoming messages |
+| `read_message` | Read a specific message |
+| `send_message` | Send a message to another agent |
+| `reply_message` | Reply to a message |
+| `generate_keys` | Create encryption keypair |
+| `list_keys` | Show known keys |
+| `import_key` | Import peer's public key |
+| `archive_message` | Archive a message |
+
+---
+
+## Usage Examples
+
+### Check inbox
+```
+"What messages do I have in my myceliumail inbox?"
+```
+
+### Send a message
+```
+"Send a myceliumail message to spidersan-agent with subject 'Need help' and body 'Can you review my PR?'"
+```
+
+### Encrypted messaging
+```
+"First generate my encryption keys, then import spidersan-agent's key: PKbSbbHJY3DstxsqjWjgfi9tP5jjM9fSqEd7BLciex8="
+"Now send an encrypted message to spidersan-agent about the secret project"
+```
+
+---
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `MYCELIUMAIL_AGENT_ID` | Your agent identity | Yes |
+| `SUPABASE_URL` | Supabase project URL | No (uses local storage) |
+| `SUPABASE_ANON_KEY` | Supabase anon key | No (uses local storage) |
+
+---
+
+## With Supabase (Cloud Sync)
+
+To enable cross-agent messaging via cloud:
+
+```json
+{
+  "mcpServers": {
+    "myceliumail": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/dist/server.js"],
+      "env": {
+        "MYCELIUMAIL_AGENT_ID": "claude-desktop",
+        "SUPABASE_URL": "https://your-project.supabase.co",
+        "SUPABASE_ANON_KEY": "your-anon-key"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Known Agents
+
+| Agent | Public Key |
+|-------|------------|
+| `mycsan` | `PKbSbbHJY3DstxsqjWjgfi9tP5jjM9fSqEd7BLciex8=` |
+
+---
+
+## Troubleshooting
+
+**MCP server not appearing in Claude Desktop**
+- Verify the path in config is correct
+- Check Claude Desktop logs: `~/Library/Logs/Claude/`
+- Ensure server builds: `npm run build`
+
+**Messages not syncing between agents**
+- Without Supabase: messages are local only
+- With Supabase: verify credentials and run migration
+
+**Encryption not working**
+- Generate keys first: use `generate_keys` tool
+- Import peer's key: use `import_key` tool
+
+---
+
+## Uninstalling
+
+Remove the `myceliumail` entry from your Claude Desktop config:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+Then restart Claude Desktop.
+

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Myceliumail MCP - Config Module
+ */
+export declare function getAgentId(): string;
+export declare function getSupabaseUrl(): string | undefined;
+export declare function getSupabaseKey(): string | undefined;
+export declare function hasSupabase(): boolean;

package/dist/lib/config.js

@@ -0,0 +1,18 @@
+/**
+ * Myceliumail MCP - Config Module
+ */
+export function getAgentId() {
+    return process.env.MYCELIUMAIL_AGENT_ID ||
+        process.env.MYCELIUMAIL_AGENT ||
+        'anonymous';
+}
+export function getSupabaseUrl() {
+    return process.env.SUPABASE_URL;
+}
+export function getSupabaseKey() {
+    return process.env.SUPABASE_ANON_KEY;
+}
+export function hasSupabase() {
+    return !!(getSupabaseUrl() && getSupabaseKey());
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,UAAU;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,WAAW,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,cAAc;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,WAAW;IACvB,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/crypto.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Myceliumail MCP - Crypto Module
+ *
+ * NaCl encryption for agent messaging.
+ */
+export interface KeyPair {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}
+export interface EncryptedMessage {
+    ciphertext: string;
+    nonce: string;
+    senderPublicKey: string;
+}
+export declare function generateKeyPair(): KeyPair;
+export declare function saveKeyPair(agentId: string, keyPair: KeyPair): void;
+export declare function loadKeyPair(agentId: string): KeyPair | null;
+export declare function hasKeyPair(agentId: string): boolean;
+export declare function getPublicKeyBase64(keyPair: KeyPair): string;
+export declare function encryptMessage(message: string, recipientPublicKey: Uint8Array, senderKeyPair: KeyPair): EncryptedMessage;
+export declare function decryptMessage(encrypted: EncryptedMessage, recipientKeyPair: KeyPair): string | null;
+export declare function loadKnownKeys(): Record<string, string>;
+export declare function saveKnownKey(agentId: string, publicKeyBase64: string): void;
+export declare function getKnownKey(agentId: string): string | null;
+export declare function listOwnKeys(): string[];
+export declare function decodePublicKey(base64: string): Uint8Array;

package/dist/lib/crypto.js

@@ -0,0 +1,110 @@
+/**
+ * Myceliumail MCP - Crypto Module
+ *
+ * NaCl encryption for agent messaging.
+ */
+import nacl from 'tweetnacl';
+import util from 'tweetnacl-util';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const KEYS_DIR = join(homedir(), '.myceliumail', 'keys');
+function ensureKeysDir() {
+    if (!existsSync(KEYS_DIR)) {
+        mkdirSync(KEYS_DIR, { recursive: true });
+    }
+}
+export function generateKeyPair() {
+    return nacl.box.keyPair();
+}
+export function saveKeyPair(agentId, keyPair) {
+    ensureKeysDir();
+    const serialized = {
+        publicKey: util.encodeBase64(keyPair.publicKey),
+        secretKey: util.encodeBase64(keyPair.secretKey),
+    };
+    const path = join(KEYS_DIR, `${agentId}.key.json`);
+    writeFileSync(path, JSON.stringify(serialized, null, 2), { mode: 0o600 });
+}
+export function loadKeyPair(agentId) {
+    const path = join(KEYS_DIR, `${agentId}.key.json`);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        return {
+            publicKey: util.decodeBase64(data.publicKey),
+            secretKey: util.decodeBase64(data.secretKey),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function hasKeyPair(agentId) {
+    return existsSync(join(KEYS_DIR, `${agentId}.key.json`));
+}
+export function getPublicKeyBase64(keyPair) {
+    return util.encodeBase64(keyPair.publicKey);
+}
+export function encryptMessage(message, recipientPublicKey, senderKeyPair) {
+    const messageBytes = util.decodeUTF8(message);
+    const nonce = nacl.randomBytes(nacl.box.nonceLength);
+    const ciphertext = nacl.box(messageBytes, nonce, recipientPublicKey, senderKeyPair.secretKey);
+    return {
+        ciphertext: util.encodeBase64(ciphertext),
+        nonce: util.encodeBase64(nonce),
+        senderPublicKey: util.encodeBase64(senderKeyPair.publicKey),
+    };
+}
+export function decryptMessage(encrypted, recipientKeyPair) {
+    try {
+        const ciphertext = util.decodeBase64(encrypted.ciphertext);
+        const nonce = util.decodeBase64(encrypted.nonce);
+        const senderPublicKey = util.decodeBase64(encrypted.senderPublicKey);
+        const decrypted = nacl.box.open(ciphertext, nonce, senderPublicKey, recipientKeyPair.secretKey);
+        if (!decrypted)
+            return null;
+        return util.encodeUTF8(decrypted);
+    }
+    catch {
+        return null;
+    }
+}
+export function loadKnownKeys() {
+    const path = join(KEYS_DIR, 'known_keys.json');
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveKnownKey(agentId, publicKeyBase64) {
+    ensureKeysDir();
+    const keys = loadKnownKeys();
+    keys[agentId] = publicKeyBase64;
+    writeFileSync(join(KEYS_DIR, 'known_keys.json'), JSON.stringify(keys, null, 2));
+}
+export function getKnownKey(agentId) {
+    const keys = loadKnownKeys();
+    return keys[agentId] || null;
+}
+export function listOwnKeys() {
+    ensureKeysDir();
+    try {
+        const files = readdirSync(KEYS_DIR);
+        return files
+            .filter(f => f.endsWith('.key.json'))
+            .map(f => f.replace('.key.json', ''));
+    }
+    catch {
+        return [];
+    }
+}
+export function decodePublicKey(base64) {
+    return util.decodeBase64(base64);
+}
+//# sourceMappingURL=crypto.js.map

package/dist/lib/crypto.js.map

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

package/dist/lib/storage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Myceliumail MCP - Storage Module
+ *
+ * Local JSON storage with optional Supabase sync.
+ */
+export interface Message {
+    id: string;
+    sender: string;
+    recipient: string;
+    subject: string;
+    body: string;
+    encrypted: boolean;
+    ciphertext?: string;
+    nonce?: string;
+    senderPublicKey?: string;
+    read: boolean;
+    archived: boolean;
+    createdAt: Date;
+}
+export declare function sendMessage(sender: string, recipient: string, subject: string, body: string, options?: {
+    encrypted?: boolean;
+    ciphertext?: string;
+    nonce?: string;
+    senderPublicKey?: string;
+}): Promise<Message>;
+export declare function getInbox(agentId: string, options?: {
+    unreadOnly?: boolean;
+    limit?: number;
+}): Promise<Message[]>;
+export declare function getMessage(id: string): Promise<Message | null>;
+export declare function markAsRead(id: string): Promise<boolean>;
+export declare function archiveMessage(id: string): Promise<boolean>;

package/dist/lib/storage.js

@@ -0,0 +1,209 @@
+/**
+ * Myceliumail MCP - Storage Module
+ *
+ * Local JSON storage with optional Supabase sync.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { randomUUID } from 'crypto';
+import { getSupabaseUrl, getSupabaseKey, hasSupabase } from './config.js';
+const DATA_DIR = join(homedir(), '.myceliumail', 'data');
+const MESSAGES_FILE = join(DATA_DIR, 'messages.json');
+function ensureDataDir() {
+    if (!existsSync(DATA_DIR)) {
+        mkdirSync(DATA_DIR, { recursive: true });
+    }
+}
+function loadLocalMessages() {
+    if (!existsSync(MESSAGES_FILE))
+        return [];
+    try {
+        return JSON.parse(readFileSync(MESSAGES_FILE, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function saveLocalMessages(messages) {
+    ensureDataDir();
+    writeFileSync(MESSAGES_FILE, JSON.stringify(messages, null, 2));
+}
+function toMessage(stored) {
+    return { ...stored, createdAt: new Date(stored.createdAt) };
+}
+// Supabase helpers
+async function supabaseRequest(path, options = {}) {
+    const url = `${getSupabaseUrl()}/rest/v1${path}`;
+    const response = await fetch(url, {
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            'apikey': getSupabaseKey(),
+            'Authorization': `Bearer ${getSupabaseKey()}`,
+            'Prefer': options.method === 'POST' ? 'return=representation' : 'return=minimal',
+            ...options.headers,
+        },
+    });
+    if (!response.ok)
+        throw new Error(await response.text());
+    if (response.status === 204)
+        return {};
+    return response.json();
+}
+export async function sendMessage(sender, recipient, subject, body, options) {
+    const newMessage = {
+        id: randomUUID(),
+        sender,
+        recipient,
+        subject: options?.encrypted ? '' : subject,
+        body: options?.encrypted ? '' : body,
+        encrypted: options?.encrypted || false,
+        ciphertext: options?.ciphertext,
+        nonce: options?.nonce,
+        senderPublicKey: options?.senderPublicKey,
+        read: false,
+        archived: false,
+        createdAt: new Date().toISOString(),
+    };
+    if (hasSupabase()) {
+        try {
+            const [result] = await supabaseRequest('/agent_messages', {
+                method: 'POST',
+                body: JSON.stringify({
+                    sender: newMessage.sender,
+                    recipient: newMessage.recipient,
+                    subject: newMessage.subject || null,
+                    body: newMessage.body || null,
+                    encrypted: newMessage.encrypted,
+                    ciphertext: newMessage.ciphertext,
+                    nonce: newMessage.nonce,
+                    sender_public_key: newMessage.senderPublicKey,
+                }),
+            });
+            return toMessage({
+                ...newMessage,
+                id: result.id
+            });
+        }
+        catch {
+            // Fall through to local
+        }
+    }
+    // Local storage
+    const messages = loadLocalMessages();
+    messages.push(newMessage);
+    saveLocalMessages(messages);
+    return toMessage(newMessage);
+}
+export async function getInbox(agentId, options) {
+    if (hasSupabase()) {
+        try {
+            let query = `/agent_messages?recipient=eq.${agentId}&archived=eq.false&order=created_at.desc`;
+            if (options?.unreadOnly)
+                query += '&read=eq.false';
+            if (options?.limit)
+                query += `&limit=${options.limit}`;
+            const results = await supabaseRequest(query);
+            return results.map(r => ({
+                id: r.id,
+                sender: r.sender,
+                recipient: r.recipient,
+                subject: r.subject || '',
+                body: r.body || '',
+                encrypted: r.encrypted,
+                ciphertext: r.ciphertext,
+                nonce: r.nonce,
+                senderPublicKey: r.sender_public_key,
+                read: r.read,
+                archived: r.archived,
+                createdAt: new Date(r.created_at),
+            }));
+        }
+        catch {
+            // Fall through to local
+        }
+    }
+    // Local storage
+    const messages = loadLocalMessages();
+    let filtered = messages.filter(m => m.recipient === agentId && !m.archived);
+    if (options?.unreadOnly)
+        filtered = filtered.filter(m => !m.read);
+    filtered.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    if (options?.limit)
+        filtered = filtered.slice(0, options.limit);
+    return filtered.map(toMessage);
+}
+export async function getMessage(id) {
+    if (hasSupabase()) {
+        try {
+            const results = await supabaseRequest(`/agent_messages?id=eq.${id}`);
+            if (results.length > 0) {
+                const r = results[0];
+                return {
+                    id: r.id,
+                    sender: r.sender,
+                    recipient: r.recipient,
+                    subject: r.subject || '',
+                    body: r.body || '',
+                    encrypted: r.encrypted,
+                    ciphertext: r.ciphertext,
+                    nonce: r.nonce,
+                    senderPublicKey: r.sender_public_key,
+                    read: r.read,
+                    archived: r.archived,
+                    createdAt: new Date(r.created_at),
+                };
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    const messages = loadLocalMessages();
+    const found = messages.find(m => m.id === id);
+    return found ? toMessage(found) : null;
+}
+export async function markAsRead(id) {
+    if (hasSupabase()) {
+        try {
+            await supabaseRequest(`/agent_messages?id=eq.${id}`, {
+                method: 'PATCH',
+                body: JSON.stringify({ read: true }),
+            });
+            return true;
+        }
+        catch {
+            // Fall through
+        }
+    }
+    const messages = loadLocalMessages();
+    const idx = messages.findIndex(m => m.id === id);
+    if (idx === -1)
+        return false;
+    messages[idx].read = true;
+    saveLocalMessages(messages);
+    return true;
+}
+export async function archiveMessage(id) {
+    if (hasSupabase()) {
+        try {
+            await supabaseRequest(`/agent_messages?id=eq.${id}`, {
+                method: 'PATCH',
+                body: JSON.stringify({ archived: true }),
+            });
+            return true;
+        }
+        catch {
+            // Fall through
+        }
+    }
+    const messages = loadLocalMessages();
+    const idx = messages.findIndex(m => m.id === id);
+    if (idx === -1)
+        return false;
+    messages[idx].archived = true;
+    saveLocalMessages(messages);
+    return true;
+}
+//# sourceMappingURL=storage.js.map

package/dist/lib/storage.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Myceliumail MCP Server
+ *
+ * Exposes Myceliumail messaging as MCP tools for Claude Desktop
+ * and other MCP-compatible clients.
+ */
+export {};