hsh19900502 1.0.21 → 1.0.22

package/CLAUDE.md

@@ -47,7 +47,8 @@ src/
 ├── commands/
 │   ├── git.ts          # Git workflow commands (gcm, push, merge, mr, branchout)
 │   ├── mono.ts         # Monorepo management (init, cd)
-│   └── ide.ts          # IDE integration (cursor, surf)
+│   ├── ide.ts          # IDE integration (cursor, surf)
+│   └── mcp.ts          # MCP server synchronization
 ├── types/
 │   └── index.ts        # TypeScript type definitions
 └── util.ts             # Utility functions (package.json reading)
@@ -91,6 +92,14 @@ The CLI follows a modular command structure using Commander.js:
 - `cursor`: Open project in Cursor editor with config-based project selection
 - `surf`: Open project in Windsurf editor with config-based project selection
 
+### MCP Server Management
+
+- `mcp sync`: Synchronize MCP server configurations from `~/.mcp/servers.json` to all projects in `~/.claude.json`
+  - This addresses the limitation that Claude Code cannot install MCP servers globally
+  - Automatically updates all project configurations with centralized MCP server definitions
+  - Idempotent operation - safe to run multiple times
+  - Useful for maintaining consistent MCP configurations across multiple projects
+
 ## Configuration Requirements
 
 ### IDE Configuration
@@ -116,6 +125,34 @@ For monorepo commands, projects should have:
 - `.hsh` marker file in the root (created by `mono init`)
 - Directory structure: `<repo-name>/client/` and `<repo-name>/server/`
 
+### MCP Server Configuration
+
+MCP (Model Context Protocol) servers can be centrally managed:
+
+- Create `~/.mcp/servers.json` with your global MCP server configurations
+- Run `hsh mcp sync` to propagate configurations to all projects in `~/.claude.json`
+- Each project's `mcpServers` field will be updated with the latest configuration
+
+Example `~/.mcp/servers.json`:
+```json
+{
+  "chrome-devtools": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["chrome-devtools-mcp@latest"],
+    "env": {}
+  },
+  "GitLab communication server": {
+    "command": "npx",
+    "args": ["-y", "@zereight/mcp-gitlab"],
+    "env": {
+      "GITLAB_PERSONAL_ACCESS_TOKEN": "your-token",
+      "GITLAB_API_URL": "https://gitlab.example.com/api/v4"
+    }
+  }
+}
+```
+
 ## External Dependencies
 
 ### Required CLI Tools

package/README.md

@@ -0,0 +1,158 @@
+# hsh - CLI Workflow Automation Tool
+
+A TypeScript-based CLI tool that provides Git workflow automation, IDE project management, and MCP server configuration synchronization.
+
+## Installation
+
+```bash
+yarn install
+yarn build:install
+```
+
+## Features
+
+### Git Workflow Automation
+- `hsh gcm <message> [--push]` - Add all, commit with message, optionally push
+- `hsh push` - Interactive branch selection for pushing to remote
+- `hsh merge <branch>` - Safe merge with branch switching and pulling
+- `hsh mr create` - Create merge requests with JIRA integration
+- `hsh branchout <branch>` - Create new branch from master
+
+### Monorepo Management
+- `hsh mono init` - Initialize workspace with `.hsh` marker file
+- `hsh mono cd <level> [--repo <name>]` - Navigate to repo directories (root/client/server)
+
+### IDE Integration
+- `hsh cursor` - Open project in Cursor editor with config-based project selection
+- `hsh claude` - Open project in Claude Code editor with config-based project selection
+
+### MCP Server Management
+
+**NEW!** Solve the problem of having to configure MCP servers individually for each project.
+
+#### The Problem
+Claude Code doesn't support global MCP server installation. You have to configure MCP servers in each project's `.claude.json` file individually, which is tedious and error-prone.
+
+#### The Solution
+`hsh mcp sync` - Synchronize MCP server configurations from a central location to all your projects
+
+#### How It Works
+
+1. Create a central MCP configuration file at `~/.mcp/servers.json`:
+
+```json
+{
+  "chrome-devtools": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["chrome-devtools-mcp@latest"],
+    "env": {}
+  },
+  "GitLab communication server": {
+    "command": "npx",
+    "args": ["-y", "@zereight/mcp-gitlab"],
+    "env": {
+      "GITLAB_PERSONAL_ACCESS_TOKEN": "your-token",
+      "GITLAB_API_URL": "https://gitlab.example.com/api/v4"
+    }
+  },
+  "jira": {
+    "command": "npx",
+    "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
+    "env": {
+      "ATLASSIAN_SITE_NAME": "your-site",
+      "ATLASSIAN_USER_EMAIL": "your-email",
+      "ATLASSIAN_API_TOKEN": "your-token"
+    }
+  }
+}
+```
+
+2. Run the sync command:
+
+```bash
+hsh mcp sync
+```
+
+3. The command will:
+   - Read all MCP server configurations from `~/.mcp/servers.json`
+   - Update the `mcpServers` field for all projects in `~/.claude.json`
+   - Show you which servers were synced and how many projects were updated
+
+#### Features
+- ✅ Idempotent - Safe to run multiple times
+- ✅ Atomic updates - Updates all projects at once
+- ✅ Clear feedback - Shows which servers and projects were updated
+- ✅ Validation - Checks for file existence and valid JSON
+
+#### Example Output
+
+```bash
+$ hsh mcp sync
+✔ Successfully synced MCP servers to 21 projects
+
+MCP Servers synced:
+  • chrome-devtools
+  • Playwright
+  • figma-mcp
+  • GitLab communication server
+  • jira
+  • confluence
+
+Projects updated:
+  • /Users/you/project1
+  • /Users/you/project2
+  • /Users/you/project3
+  ... and 18 more
+```
+
+## Configuration
+
+### IDE Configuration
+Create `~/hsh.config.json` for IDE project management:
+
+```json
+{
+  "work": {
+    "project1": "/path/to/work/project1",
+    "project2": "/path/to/work/project2"
+  },
+  "personal": {
+    "project3": "/path/to/personal/project3"
+  }
+}
+```
+
+### Monorepo Setup
+For monorepo commands, projects should have:
+- `.hsh` marker file in the root (created by `hsh mono init`)
+- Directory structure: `<repo-name>/client/` and `<repo-name>/server/`
+
+## Development
+
+```bash
+# Install dependencies
+yarn install
+
+# Build the project
+yarn build
+
+# Build and install globally
+yarn build:install
+
+# Development mode
+yarn dev
+```
+
+## Requirements
+
+- Node.js with ES module support
+- Git
+- GitLab CLI (`glab`) for merge request features
+- Cursor editor (for `cursor` command)
+- Claude Code editor (for `claude` command)
+
+## License
+
+MIT
+

package/dist/commands/mcp.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Sync MCP servers from ~/.mcp/servers.json to all projects in ~/.claude.json
+ */
+export declare function syncMcpServers(): Promise<void>;

package/dist/commands/mcp.js

@@ -0,0 +1,79 @@
+import { readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+/**
+ * Sync MCP servers from ~/.mcp/servers.json to all projects in ~/.claude.json
+ */
+export async function syncMcpServers() {
+    const spinner = ora('Syncing MCP servers...').start();
+    try {
+        // Read MCP servers configuration
+        const mcpConfigPath = join(homedir(), '.mcp', 'servers.json');
+        const claudeConfigPath = join(homedir(), '.claude.json');
+        let mcpServers;
+        try {
+            const mcpConfigContent = readFileSync(mcpConfigPath, 'utf-8');
+            mcpServers = JSON.parse(mcpConfigContent);
+            spinner.text = `Found ${Object.keys(mcpServers).length} MCP servers`;
+        }
+        catch (error) {
+            spinner.fail(chalk.red(`Failed to read MCP servers from ${mcpConfigPath}`));
+            console.error(chalk.yellow(`Please ensure ${mcpConfigPath} exists and is valid JSON`));
+            return;
+        }
+        // Read Claude configuration
+        let claudeConfig;
+        try {
+            const claudeConfigContent = readFileSync(claudeConfigPath, 'utf-8');
+            claudeConfig = JSON.parse(claudeConfigContent);
+        }
+        catch (error) {
+            spinner.fail(chalk.red(`Failed to read Claude config from ${claudeConfigPath}`));
+            return;
+        }
+        // Check if there are any projects
+        if (!claudeConfig.projects || Object.keys(claudeConfig.projects).length === 0) {
+            spinner.warn(chalk.yellow('No projects found in ~/.claude.json'));
+            return;
+        }
+        // Update each project with MCP servers
+        const projectPaths = Object.keys(claudeConfig.projects);
+        spinner.text = `Updating ${projectPaths.length} projects...`;
+        let updatedCount = 0;
+        for (const projectPath of projectPaths) {
+            const project = claudeConfig.projects[projectPath];
+            // Check if mcpServers need to be updated
+            const currentServers = JSON.stringify(project.mcpServers || {});
+            const newServers = JSON.stringify(mcpServers);
+            if (currentServers !== newServers) {
+                project.mcpServers = mcpServers;
+                updatedCount++;
+            }
+        }
+        // Write back to ~/.claude.json
+        if (updatedCount > 0) {
+            writeFileSync(claudeConfigPath, JSON.stringify(claudeConfig, null, 2), 'utf-8');
+            spinner.succeed(chalk.green(`✓ Successfully synced MCP servers to ${updatedCount} project${updatedCount > 1 ? 's' : ''}`));
+            console.log(chalk.cyan('\nMCP Servers synced:'));
+            Object.keys(mcpServers).forEach(serverName => {
+                console.log(chalk.gray(`  • ${serverName}`));
+            });
+            console.log(chalk.cyan('\nProjects updated:'));
+            projectPaths.slice(0, 5).forEach(path => {
+                console.log(chalk.gray(`  • ${path}`));
+            });
+            if (projectPaths.length > 5) {
+                console.log(chalk.gray(`  ... and ${projectPaths.length - 5} more`));
+            }
+        }
+        else {
+            spinner.info(chalk.blue('All projects already have the latest MCP servers configuration'));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to sync MCP servers'));
+        console.error(chalk.red(error.message));
+    }
+}

package/dist/hsh.js

@@ -5,6 +5,7 @@ import { initMonoRepo, monoCd } from './commands/mono.js';
 import { getPackageJson } from './util.js';
 import { openIDE } from './commands/ide.js';
 import { cloudLogin, cloudScp } from './commands/cloud.js';
+import { syncMcpServers } from './commands/mcp.js';
 const packageJson = getPackageJson();
 const program = new Command();
 program.usage('<command> [options]');
@@ -90,4 +91,14 @@ cloudCommand
     .action(async (localPath, remotePath, options) => {
     await cloudScp(localPath, remotePath, options);
 });
+// MCP management commands
+const mcpCommand = program
+    .command('mcp')
+    .description('MCP (Model Context Protocol) server management');
+mcpCommand
+    .command('sync')
+    .description('Sync MCP servers from ~/.mcp/servers.json to all projects in ~/.claude.json')
+    .action(async () => {
+    await syncMcpServers();
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hsh19900502",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "type": "module",
   "description": "",
   "main": "index.js",

package/src/commands/mcp.ts

@@ -0,0 +1,118 @@
+import { $ } from 'zx';
+import { readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+
+interface McpServerConfig {
+  [serverName: string]: {
+    type?: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+  };
+}
+
+interface ClaudeConfig {
+  projects: {
+    [projectPath: string]: {
+      mcpServers?: McpServerConfig;
+      [key: string]: any;
+    };
+  };
+  [key: string]: any;
+}
+
+/**
+ * Sync MCP servers from ~/.mcp/servers.json to all projects in ~/.claude.json
+ */
+export async function syncMcpServers() {
+  const spinner = ora('Syncing MCP servers...').start();
+
+  try {
+    // Read MCP servers configuration
+    const mcpConfigPath = join(homedir(), '.mcp', 'servers.json');
+    const claudeConfigPath = join(homedir(), '.claude.json');
+
+    let mcpServers: McpServerConfig;
+    try {
+      const mcpConfigContent = readFileSync(mcpConfigPath, 'utf-8');
+      mcpServers = JSON.parse(mcpConfigContent);
+      spinner.text = `Found ${Object.keys(mcpServers).length} MCP servers`;
+    } catch (error) {
+      spinner.fail(chalk.red(`Failed to read MCP servers from ${mcpConfigPath}`));
+      console.error(chalk.yellow(`Please ensure ${mcpConfigPath} exists and is valid JSON`));
+      return;
+    }
+
+    // Read Claude configuration
+    let claudeConfig: ClaudeConfig;
+    try {
+      const claudeConfigContent = readFileSync(claudeConfigPath, 'utf-8');
+      claudeConfig = JSON.parse(claudeConfigContent);
+    } catch (error) {
+      spinner.fail(chalk.red(`Failed to read Claude config from ${claudeConfigPath}`));
+      return;
+    }
+
+    // Check if there are any projects
+    if (!claudeConfig.projects || Object.keys(claudeConfig.projects).length === 0) {
+      spinner.warn(chalk.yellow('No projects found in ~/.claude.json'));
+      return;
+    }
+
+    // Update each project with MCP servers
+    const projectPaths = Object.keys(claudeConfig.projects);
+    spinner.text = `Updating ${projectPaths.length} projects...`;
+
+    let updatedCount = 0;
+    for (const projectPath of projectPaths) {
+      const project = claudeConfig.projects[projectPath];
+      
+      // Check if mcpServers need to be updated
+      const currentServers = JSON.stringify(project.mcpServers || {});
+      const newServers = JSON.stringify(mcpServers);
+      
+      if (currentServers !== newServers) {
+        project.mcpServers = mcpServers;
+        updatedCount++;
+      }
+    }
+
+    // Write back to ~/.claude.json
+    if (updatedCount > 0) {
+      writeFileSync(
+        claudeConfigPath,
+        JSON.stringify(claudeConfig, null, 2),
+        'utf-8'
+      );
+      
+      spinner.succeed(
+        chalk.green(
+          `✓ Successfully synced MCP servers to ${updatedCount} project${updatedCount > 1 ? 's' : ''}`
+        )
+      );
+      
+      console.log(chalk.cyan('\nMCP Servers synced:'));
+      Object.keys(mcpServers).forEach(serverName => {
+        console.log(chalk.gray(`  • ${serverName}`));
+      });
+      
+      console.log(chalk.cyan('\nProjects updated:'));
+      projectPaths.slice(0, 5).forEach(path => {
+        console.log(chalk.gray(`  • ${path}`));
+      });
+      if (projectPaths.length > 5) {
+        console.log(chalk.gray(`  ... and ${projectPaths.length - 5} more`));
+      }
+    } else {
+      spinner.info(chalk.blue('All projects already have the latest MCP servers configuration'));
+    }
+
+  } catch (error: any) {
+    spinner.fail(chalk.red('Failed to sync MCP servers'));
+    console.error(chalk.red(error.message));
+  }
+}
+

package/src/hsh.ts

@@ -6,6 +6,7 @@ import { RepoDirLevel } from './types/index.js';
 import { getPackageJson } from './util.js';
 import { openIDE } from './commands/ide.js';
 import { cloudLogin, cloudScp } from './commands/cloud.js';
+import { syncMcpServers } from './commands/mcp.js';
 
 const packageJson = getPackageJson();
 
@@ -108,4 +109,16 @@ cloudCommand
     await cloudScp(localPath, remotePath, options);
   });
 
+// MCP management commands
+const mcpCommand = program
+  .command('mcp')
+  .description('MCP (Model Context Protocol) server management');
+
+mcpCommand
+  .command('sync')
+  .description('Sync MCP servers from ~/.mcp/servers.json to all projects in ~/.claude.json')
+  .action(async () => {
+    await syncMcpServers();
+  });
+
 program.parse();