@proofofprotocol/inscribe-mcp 0.2.0 → 0.3.1

package/README.md

@@ -45,13 +45,21 @@ Hedera Testnet アカウントは [portal.hedera.com](https://portal.hedera.com)
 
 ### 3. Claude Desktop に接続
 
+```bash
+# 自動設定（推奨）
+inscribe-mcp setup-mcp --claude-desktop
+
+# または手動設定
+inscribe-mcp setup-mcp --show-json
+```
+
 `claude_desktop_config.json`:
 ```json
 {
   "mcpServers": {
     "inscribe": {
       "command": "npx",
-      "args": ["@proofofprotocol/inscribe-mcp-server"]
+      "args": ["-y", "@proofofprotocol/inscribe-mcp", "inscribe-mcp-server"]
     }
   }
 }

package/package.json

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

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: ['-y', '@proofofprotocol/inscribe-mcp', '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);