@proofofprotocol/inscribe-mcp 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofofprotocol/inscribe-mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Verifiable inscription for AI agents - inscribe anything to blockchain with Hedera HCS",
   "type": "module",
   "main": "src/server.js",

package/src/cli/commands/init.js

@@ -6,8 +6,11 @@
 
 import { Command } from 'commander';
 import { createInterface } from 'readline';
+import { PrivateKey } from '@hashgraph/sdk';
 import { writeConfig, configExists, getConfigPath } from '../lib/config.js';
 import { EXIT_CODES } from '../lib/exit-codes.js';
+import { exec } from 'child_process';
+import { platform } from 'os';
 
 // Simple prompt helper (no external dependency)
 function prompt(question) {
@@ -34,6 +37,57 @@ const colors = {
   dim: (s) => `\x1b[2m${s}\x1b[0m`
 };
 
+// Open URL in browser
+function openBrowser(url) {
+  const os = platform();
+  let cmd;
+  if (os === 'darwin') {
+    cmd = `open "${url}"`;
+  } else if (os === 'win32') {
+    cmd = `start "" "${url}"`;
+  } else {
+    cmd = `xdg-open "${url}"`;
+  }
+  exec(cmd, () => {});
+}
+
+// Generate ECDSA key pair and EVM address
+function generateKeyPair() {
+  const privateKey = PrivateKey.generateECDSA();
+  const publicKey = privateKey.publicKey;
+
+  // Get EVM address from public key
+  const evmAddress = publicKey.toEvmAddress();
+
+  return {
+    privateKey: privateKey.toStringDer(),
+    privateKeyRaw: privateKey.toStringRaw(),
+    publicKey: publicKey.toStringDer(),
+    evmAddress: `0x${evmAddress}`
+  };
+}
+
+// Fetch account ID from EVM address via Mirror Node
+async function fetchAccountIdFromEvmAddress(evmAddress, network) {
+  const mirrorUrl = network === 'mainnet'
+    ? 'https://mainnet.mirrornode.hedera.com'
+    : 'https://testnet.mirrornode.hedera.com';
+
+  // Remove 0x prefix if present
+  const address = evmAddress.startsWith('0x') ? evmAddress.slice(2) : evmAddress;
+
+  try {
+    const response = await fetch(`${mirrorUrl}/api/v1/accounts/${address}`);
+    if (response.ok) {
+      const data = await response.json();
+      return data.account;
+    }
+  } catch {
+    // Ignore errors
+  }
+  return null;
+}
+
 export const initCommand = new Command('init')
   .description('Initialize inscribe-mcp configuration')
   .option('-f, --force', 'Overwrite existing configuration')
@@ -90,53 +144,162 @@ export const initCommand = new Command('init')
     console.log(colors.bold('2. Hedera Account'));
     console.log('');
 
+    let accountId;
+    let privateKey;
+
     if (network === 'testnet') {
-      console.log(colors.cyan('Testnet Faucet:'));
-      console.log('  https://portal.hedera.com/faucet');
+      // Testnet: offer new or existing account
+      console.log('  1) ' + colors.cyan('Create new account') + colors.dim(' (generate key + faucet)'));
+      console.log('  2) ' + colors.dim('Use existing account'));
       console.log('');
-      console.log('Create an account and get free HBAR for testing.');
+
+      let accountChoice;
+      while (!accountChoice) {
+        const choice = await prompt('Select (1 or 2): ');
+        if (choice === '1') accountChoice = 'new';
+        else if (choice === '2') accountChoice = 'existing';
+        else console.log(colors.red('Invalid selection. Enter 1 or 2.'));
+      }
       console.log('');
+
+      if (accountChoice === 'new') {
+        // Generate new key pair
+        console.log(colors.bold('Generating ECDSA key pair...'));
+        const keyPair = generateKeyPair();
+        console.log('');
+        console.log(colors.green('✓') + ' Key pair generated');
+        console.log('');
+        console.log(colors.bold('Your EVM Address:'));
+        console.log(colors.cyan(`  ${keyPair.evmAddress}`));
+        console.log('');
+
+        privateKey = keyPair.privateKey;
+
+        // Open faucet
+        console.log(colors.bold('3. Get Free HBAR'));
+        console.log('');
+        console.log('Opening faucet in browser...');
+        console.log(colors.dim('  https://portal.hedera.com/faucet'));
+        console.log('');
+        openBrowser('https://portal.hedera.com/faucet');
+
+        console.log('Steps:');
+        console.log('  1. Paste your EVM address above in the faucet');
+        console.log('  2. Click "RECEIVE 100 TESTNET HBAR"');
+        console.log('  3. Wait a few seconds for the account to be created');
+        console.log('');
+
+        await prompt('Press Enter when you have received HBAR...');
+        console.log('');
+
+        // Try to fetch account ID automatically
+        console.log('Looking up your Account ID...');
+        let retries = 3;
+        while (retries > 0 && !accountId) {
+          accountId = await fetchAccountIdFromEvmAddress(keyPair.evmAddress, network);
+          if (!accountId) {
+            retries--;
+            if (retries > 0) {
+              console.log(colors.dim('  Waiting for account creation...'));
+              await new Promise(r => setTimeout(r, 3000));
+            }
+          }
+        }
+
+        if (accountId) {
+          console.log(colors.green('✓') + ` Account ID: ${accountId}`);
+        } else {
+          console.log(colors.yellow('Could not find Account ID automatically.'));
+          console.log('');
+          console.log('Check HashScan:');
+          console.log(colors.cyan(`  https://hashscan.io/testnet/account/${keyPair.evmAddress.slice(2)}`));
+          console.log('');
+          while (!accountId) {
+            const input = await prompt('Enter your Account ID (e.g., 0.0.123456): ');
+            if (/^0\.0\.\d+$/.test(input)) {
+              accountId = input;
+            } else {
+              console.log(colors.red('Invalid format. Use 0.0.XXXXXX'));
+            }
+          }
+        }
+        console.log('');
+
+      } else {
+        // Existing account
+        console.log(colors.cyan('Enter your existing Hedera account details.'));
+        console.log('');
+
+        while (!accountId) {
+          const input = await prompt('Account ID (e.g., 0.0.123456): ');
+          if (/^0\.0\.\d+$/.test(input)) {
+            accountId = input;
+          } else {
+            console.log(colors.red('Invalid format. Use 0.0.XXXXXX'));
+          }
+        }
+
+        console.log(colors.green('✓') + ` Account ID: ${accountId}`);
+        console.log('');
+
+        // Private key input
+        console.log(colors.bold('3. Private Key'));
+        console.log('');
+        console.log(colors.dim('Your private key is stored locally and never transmitted.'));
+        console.log('');
+
+        while (!privateKey) {
+          const input = await prompt('Private Key (hex or DER format): ');
+          if (input.length >= 32) {
+            privateKey = input;
+          } else {
+            console.log(colors.red('Private key seems too short.'));
+          }
+        }
+
+        console.log(colors.green('✓') + ' Private key received');
+        console.log('');
+      }
+
     } else {
+      // Mainnet: always use existing account
       console.log(colors.cyan('Create Mainnet Account:'));
       console.log('  HashPack: https://www.hashpack.app/');
       console.log('  Blade: https://www.bladewallet.io/');
       console.log('');
       console.log('Transfer a small amount of HBAR (1-5 HBAR recommended).');
       console.log('');
-    }
 
-    // Account ID input
-    let accountId;
-    while (!accountId) {
-      const input = await prompt('Account ID (e.g., 0.0.123456): ');
-      if (/^0\.0\.\d+$/.test(input)) {
-        accountId = input;
-      } else {
-        console.log(colors.red('Invalid format. Use 0.0.XXXXXX'));
+      while (!accountId) {
+        const input = await prompt('Account ID (e.g., 0.0.123456): ');
+        if (/^0\.0\.\d+$/.test(input)) {
+          accountId = input;
+        } else {
+          console.log(colors.red('Invalid format. Use 0.0.XXXXXX'));
+        }
       }
-    }
 
-    console.log(colors.green('✓') + ` Account ID: ${accountId}`);
-    console.log('');
+      console.log(colors.green('✓') + ` Account ID: ${accountId}`);
+      console.log('');
 
-    // Private key input
-    console.log(colors.bold('3. Private Key'));
-    console.log('');
-    console.log(colors.dim('Your private key is stored locally and never transmitted.'));
-    console.log('');
+      // Private key input
+      console.log(colors.bold('3. Private Key'));
+      console.log('');
+      console.log(colors.dim('Your private key is stored locally and never transmitted.'));
+      console.log('');
 
-    let privateKey;
-    while (!privateKey) {
-      const input = await prompt('Private Key (hex or DER format): ');
-      if (input.length >= 32) {
-        privateKey = input;
-      } else {
-        console.log(colors.red('Private key seems too short.'));
+      while (!privateKey) {
+        const input = await prompt('Private Key (hex or DER format): ');
+        if (input.length >= 32) {
+          privateKey = input;
+        } else {
+          console.log(colors.red('Private key seems too short.'));
+        }
       }
-    }
 
-    console.log(colors.green('✓') + ' Private key received');
-    console.log('');
+      console.log(colors.green('✓') + ' Private key received');
+      console.log('');
+    }
 
     // Topic ID (optional)
     console.log(colors.bold('4. Topic ID (optional)'));

package/src/cli/commands/setup-mcp.js

@@ -0,0 +1,205 @@
+/**
+ * setup-mcp command
+ *
+ * Configure MCP client to use inscribe-mcp server.
+ */
+
+import { Command } from 'commander';
+import { createInterface } from 'readline';
+import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
+import { homedir, platform } from 'os';
+import { join } from 'path';
+import { EXIT_CODES } from '../lib/exit-codes.js';
+import { configExists } from '../lib/config.js';
+
+// Simple prompt helper
+function prompt(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+// ANSI colors
+const colors = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`
+};
+
+// Get Claude Desktop config path based on OS
+function getClaudeDesktopConfigPath() {
+  const os = platform();
+  if (os === 'darwin') {
+    return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  } else if (os === 'win32') {
+    return join(process.env.APPDATA || join(homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+  } else {
+    // Linux
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+  }
+}
+
+// MCP server config for inscribe
+const INSCRIBE_MCP_CONFIG = {
+  command: 'npx',
+  args: ['@proofofprotocol/inscribe-mcp-server']
+};
+
+// Generate JSON snippet for display
+function generateJsonSnippet() {
+  return JSON.stringify({
+    mcpServers: {
+      inscribe: INSCRIBE_MCP_CONFIG
+    }
+  }, null, 2);
+}
+
+export const setupMcpCommand = new Command('setup-mcp')
+  .description('Configure MCP client to use inscribe-mcp server')
+  .option('--claude-desktop', 'Configure Claude Desktop automatically')
+  .option('--show-json', 'Just show the JSON configuration')
+  .action(async (options) => {
+    console.log('');
+    console.log(colors.bold('inscribe-mcp MCP Setup'));
+    console.log('─'.repeat(40));
+    console.log('');
+
+    // Check if inscribe-mcp is configured
+    if (!configExists()) {
+      console.log(colors.yellow('⚠ inscribe-mcp is not configured yet.'));
+      console.log('');
+      console.log('Run ' + colors.cyan('inscribe-mcp init') + ' first to set up your Hedera account.');
+      console.log('');
+      process.exit(EXIT_CODES.ERROR);
+    }
+
+    // If --show-json, just display and exit
+    if (options.showJson) {
+      console.log('Add this to your MCP client configuration:');
+      console.log('');
+      console.log(colors.cyan(generateJsonSnippet()));
+      console.log('');
+      process.exit(EXIT_CODES.SUCCESS);
+    }
+
+    // If --claude-desktop, skip selection
+    let clientChoice = options.claudeDesktop ? 'claude' : null;
+
+    if (!clientChoice) {
+      console.log(colors.bold('Select MCP Client'));
+      console.log('');
+      console.log('  1) ' + colors.cyan('Claude Desktop') + colors.dim(' (auto-configure)'));
+      console.log('  2) ' + colors.dim('Other MCP client') + colors.dim(' (show JSON)'));
+      console.log('');
+
+      while (!clientChoice) {
+        const choice = await prompt('Select (1 or 2): ');
+        if (choice === '1') clientChoice = 'claude';
+        else if (choice === '2') clientChoice = 'other';
+        else console.log(colors.red('Invalid selection. Enter 1 or 2.'));
+      }
+      console.log('');
+    }
+
+    if (clientChoice === 'other') {
+      // Just show JSON
+      console.log(colors.bold('MCP Configuration'));
+      console.log('');
+      console.log('Add this to your MCP client configuration:');
+      console.log('');
+      console.log(colors.cyan(generateJsonSnippet()));
+      console.log('');
+      process.exit(EXIT_CODES.SUCCESS);
+    }
+
+    // Claude Desktop configuration
+    console.log(colors.bold('Claude Desktop Configuration'));
+    console.log('');
+
+    const configPath = getClaudeDesktopConfigPath();
+    console.log('Config file: ' + colors.dim(configPath));
+    console.log('');
+
+    // Check if config file exists
+    let existingConfig = { mcpServers: {} };
+    let configFileExists = false;
+
+    if (existsSync(configPath)) {
+      configFileExists = true;
+      try {
+        const content = readFileSync(configPath, 'utf-8');
+        existingConfig = JSON.parse(content);
+        if (!existingConfig.mcpServers) {
+          existingConfig.mcpServers = {};
+        }
+      } catch (error) {
+        console.log(colors.yellow('⚠ Could not parse existing config, will create new one.'));
+        existingConfig = { mcpServers: {} };
+      }
+    }
+
+    // Check if inscribe is already configured
+    if (existingConfig.mcpServers.inscribe) {
+      console.log(colors.yellow('inscribe is already configured in Claude Desktop.'));
+      console.log('');
+      const confirm = await prompt('Overwrite? (yes/no): ');
+      if (confirm.toLowerCase() !== 'yes') {
+        console.log('Aborted.');
+        process.exit(EXIT_CODES.SUCCESS);
+      }
+      console.log('');
+    }
+
+    // Backup existing config if it exists
+    if (configFileExists) {
+      const backupPath = configPath + '.backup.' + Date.now();
+      try {
+        copyFileSync(configPath, backupPath);
+        console.log(colors.green('✓') + ' Backup created: ' + colors.dim(backupPath));
+      } catch (error) {
+        console.log(colors.yellow('⚠ Could not create backup: ' + error.message));
+      }
+    }
+
+    // Add inscribe config
+    existingConfig.mcpServers.inscribe = INSCRIBE_MCP_CONFIG;
+
+    // Write new config
+    try {
+      writeFileSync(configPath, JSON.stringify(existingConfig, null, 2), 'utf-8');
+      console.log(colors.green('✓') + ' Configuration updated');
+    } catch (error) {
+      console.log(colors.red('✗ Failed to write config: ' + error.message));
+      console.log('');
+      console.log('You may need to create the config file manually:');
+      console.log(colors.cyan(configPath));
+      console.log('');
+      console.log('With content:');
+      console.log(colors.cyan(generateJsonSnippet()));
+      console.log('');
+      process.exit(EXIT_CODES.ERROR);
+    }
+
+    console.log('');
+    console.log('─'.repeat(40));
+    console.log(colors.green(colors.bold('✓ Setup Complete!')));
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. ' + colors.cyan('Restart Claude Desktop'));
+    console.log('  2. Look for "inscribe" in the MCP tools menu');
+    console.log('  3. Try: "このテキストを刻んで: Hello World"');
+    console.log('');
+
+    process.exit(EXIT_CODES.SUCCESS);
+  });

package/src/cli/index.js

@@ -17,6 +17,7 @@ import { configCommand } from './commands/config.js';
 import { balanceCommand } from './commands/balance.js';
 import { logCommand } from './commands/log.js';
 import { showCommand } from './commands/show.js';
+import { setupMcpCommand } from './commands/setup-mcp.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -35,6 +36,7 @@ program
 
 // Register commands
 program.addCommand(initCommand);
+program.addCommand(setupMcpCommand);
 program.addCommand(configCommand);
 program.addCommand(balanceCommand);
 program.addCommand(logCommand);