@ebowwa/claude-code-config-mcp 1.0.0

package/src/utils/path.js

@@ -0,0 +1,169 @@
+"use strict";
+// ============================================================================
+// Path Utilities - Cross-platform path handling for Claude Code config
+// ============================================================================
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHomeDir = getHomeDir;
+exports.getClaudeConfigDir = getClaudeConfigDir;
+exports.getClaudeAppConfigDir = getClaudeAppConfigDir;
+exports.getClaudeCliConfigPath = getClaudeCliConfigPath;
+exports.getProjectClaudeDir = getProjectClaudeDir;
+exports.getConfigPaths = getConfigPaths;
+exports.validatePath = validatePath;
+exports.pathExists = pathExists;
+exports.getDisplayPath = getDisplayPath;
+exports.getMCPConfigPaths = getMCPConfigPaths;
+var node_path_1 = require("node:path");
+var node_os_1 = require("node:os");
+var node_fs_1 = require("node:fs");
+/**
+ * Get home directory cross-platform
+ */
+function getHomeDir() {
+    return (0, node_os_1.homedir)();
+}
+/**
+ * Get Claude Code global config directory (~/.claude)
+ */
+function getClaudeConfigDir() {
+    return (0, node_path_1.join)(getHomeDir(), '.claude');
+}
+/**
+ * Get Claude Code app config directory (~/.config/claude-code)
+ * This is where MCP servers are configured for the Claude Code app
+ */
+function getClaudeAppConfigDir() {
+    return (0, node_path_1.join)(getHomeDir(), '.config', 'claude-code');
+}
+/**
+ * Get Claude CLI config file path (~/.claude.json)
+ * This is where MCP servers are configured for the claude CLI
+ */
+function getClaudeCliConfigPath() {
+    return (0, node_path_1.join)(getHomeDir(), '.claude.json');
+}
+/**
+ * Get project-local Claude Code config directory (.claude)
+ */
+function getProjectClaudeDir(cwd) {
+    if (cwd === void 0) { cwd = process.cwd(); }
+    return (0, node_path_1.join)(cwd, '.claude');
+}
+/**
+ * Resolve Claude config file paths
+ */
+function getConfigPaths(cwd) {
+    if (cwd === void 0) { cwd = process.cwd(); }
+    var claudeDir = getClaudeConfigDir();
+    var claudeAppDir = getClaudeAppConfigDir();
+    var projectClaudeDir = getProjectClaudeDir(cwd);
+    return {
+        // Global config files
+        globalClaudeMd: (0, node_path_1.join)(claudeDir, 'CLAUDE.md'),
+        keybindings: (0, node_path_1.join)(claudeDir, 'keybindings.json'),
+        settings: (0, node_path_1.join)(claudeDir, 'settings.json'),
+        claudeJson: (0, node_path_1.join)(claudeDir, 'claude.json'),
+        mcpServers: (0, node_path_1.join)(claudeDir, 'mcp_servers.json'),
+        hooksDir: (0, node_path_1.join)(claudeDir, 'hooks'),
+        pluginsDir: (0, node_path_1.join)(claudeDir, 'plugins'),
+        // App config file (where MCP servers are actually configured)
+        appConfig: (0, node_path_1.join)(claudeAppDir, 'config.json'),
+        // Project-local config files
+        projectClaudeMd: (0, node_path_1.join)(projectClaudeDir, 'CLAUDE.md'),
+    };
+}
+/**
+ * Allowed base paths for security (whitelist)
+ */
+var ALLOWED_BASES = [
+    getClaudeConfigDir(),
+    getProjectClaudeDir(),
+    getClaudeAppConfigDir(),
+    getClaudeCliConfigPath(),
+];
+/**
+ * Validate and sanitize a file path
+ * Prevents path traversal attacks and ensures path is within allowed directories
+ */
+function validatePath(userPath, cwd) {
+    if (cwd === void 0) { cwd = process.cwd(); }
+    // Normalize path
+    var normalized = (0, node_path_1.normalize)(userPath.replace(/\0/g, ''));
+    // Resolve to absolute path
+    var absolute = (0, node_path_1.isAbsolute)(normalized)
+        ? (0, node_path_1.resolve)(normalized)
+        : (0, node_path_1.resolve)(cwd, normalized);
+    // Check for path traversal attempts
+    if (normalized.includes('..')) {
+        throw new Error('Path traversal detected');
+    }
+    // Build allowed bases including the current project directory
+    var allowedBases = __spreadArray(__spreadArray([], ALLOWED_BASES, true), [
+        getClaudeConfigDir(),
+        getProjectClaudeDir(cwd),
+    ], false);
+    // Check if path is within allowed bases
+    // For files that don't exist yet, check the parent directory
+    var checkPath = absolute;
+    while (checkPath !== '/' && checkPath !== cwd && checkPath !== getHomeDir()) {
+        var isAllowed = allowedBases.some(function (base) {
+            var resolvedBase = (0, node_path_1.resolve)(base);
+            return (checkPath === resolvedBase ||
+                checkPath.startsWith(resolvedBase + '/') ||
+                resolvedBase.startsWith(checkPath + '/'));
+        });
+        if (isAllowed) {
+            return absolute;
+        }
+        // Move up one directory to check
+        checkPath = (0, node_path_1.dirname)(checkPath);
+    }
+    // If we get here, the path is not allowed
+    throw new Error("Path not allowed: ".concat(userPath));
+}
+/**
+ * Check if a path exists
+ */
+function pathExists(filePath) {
+    try {
+        return (0, node_fs_1.existsSync)(filePath);
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Get relative path from home directory for display
+ */
+function getDisplayPath(filePath) {
+    var home = getHomeDir();
+    if (filePath.startsWith(home)) {
+        return filePath.replace(home, '~');
+    }
+    return filePath;
+}
+/**
+ * Get MCP config file paths based on target
+ * @param target - Which config(s) to get ('cli', 'app', or 'both')
+ * @returns Object with the requested config paths
+ */
+function getMCPConfigPaths(target) {
+    if (target === void 0) { target = 'both'; }
+    var result = {};
+    if (target === 'cli' || target === 'both') {
+        result.cli = getClaudeCliConfigPath();
+    }
+    if (target === 'app' || target === 'both') {
+        result.app = getConfigPaths().appConfig;
+    }
+    return result;
+}

package/src/utils/path.ts

@@ -0,0 +1,173 @@
+// ============================================================================
+// Path Utilities - Cross-platform path handling for Claude Code config
+// ============================================================================
+
+import { resolve, normalize, isAbsolute, join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, realpathSync } from 'node:fs';
+
+/**
+ * Get home directory cross-platform
+ */
+export function getHomeDir(): string {
+  return homedir();
+}
+
+/**
+ * Get Claude Code global config directory (~/.claude)
+ */
+export function getClaudeConfigDir(): string {
+  return join(getHomeDir(), '.claude');
+}
+
+/**
+ * Get Claude Code app config directory (~/.config/claude-code)
+ * This is where MCP servers are configured for the Claude Code app
+ */
+export function getClaudeAppConfigDir(): string {
+  return join(getHomeDir(), '.config', 'claude-code');
+}
+
+/**
+ * Get Claude CLI config file path (~/.claude.json)
+ * This is where MCP servers are configured for the claude CLI
+ */
+export function getClaudeCliConfigPath(): string {
+  return join(getHomeDir(), '.claude.json');
+}
+
+/**
+ * Get project-local Claude Code config directory (.claude)
+ */
+export function getProjectClaudeDir(cwd: string = process.cwd()): string {
+  return join(cwd, '.claude');
+}
+
+/**
+ * Resolve Claude config file paths
+ */
+export function getConfigPaths(cwd: string = process.cwd()) {
+  const claudeDir = getClaudeConfigDir();
+  const claudeAppDir = getClaudeAppConfigDir();
+  const projectClaudeDir = getProjectClaudeDir(cwd);
+
+  return {
+    // Global config files
+    globalClaudeMd: join(claudeDir, 'CLAUDE.md'),
+    keybindings: join(claudeDir, 'keybindings.json'),
+    settings: join(claudeDir, 'settings.json'),
+    claudeJson: join(claudeDir, 'claude.json'),
+    mcpServers: join(claudeDir, 'mcp_servers.json'),
+    hooksDir: join(claudeDir, 'hooks'),
+    pluginsDir: join(claudeDir, 'plugins'),
+
+    // App config file (where MCP servers are actually configured)
+    appConfig: join(claudeAppDir, 'config.json'),
+
+    // Project-local config files
+    projectClaudeMd: join(projectClaudeDir, 'CLAUDE.md'),
+  };
+}
+
+/**
+ * Allowed base paths for security (whitelist)
+ */
+const ALLOWED_BASES = [
+  getClaudeConfigDir(),
+  getProjectClaudeDir(),
+  getClaudeAppConfigDir(),
+  getClaudeCliConfigPath(),
+];
+
+/**
+ * Validate and sanitize a file path
+ * Prevents path traversal attacks and ensures path is within allowed directories
+ */
+export function validatePath(userPath: string, cwd: string = process.cwd()): string {
+  // Normalize path
+  const normalized = normalize(userPath.replace(/\0/g, ''));
+
+  // Resolve to absolute path
+  const absolute = isAbsolute(normalized)
+    ? resolve(normalized)
+    : resolve(cwd, normalized);
+
+  // Check for path traversal attempts
+  if (normalized.includes('..')) {
+    throw new Error('Path traversal detected');
+  }
+
+  // Build allowed bases including the current project directory
+  const allowedBases = [
+    ...ALLOWED_BASES,
+    getClaudeConfigDir(),
+    getProjectClaudeDir(cwd),
+  ];
+
+  // Check if path is within allowed bases
+  // For files that don't exist yet, check the parent directory
+  let checkPath = absolute;
+  while (checkPath !== '/' && checkPath !== cwd && checkPath !== getHomeDir()) {
+    const isAllowed = allowedBases.some(base => {
+      const resolvedBase = resolve(base);
+      return (
+        checkPath === resolvedBase ||
+        checkPath.startsWith(resolvedBase + '/') ||
+        resolvedBase.startsWith(checkPath + '/')
+      );
+    });
+
+    if (isAllowed) {
+      return absolute;
+    }
+
+    // Move up one directory to check
+    checkPath = dirname(checkPath);
+  }
+
+  // If we get here, the path is not allowed
+  throw new Error(`Path not allowed: ${userPath}`);
+}
+
+/**
+ * Check if a path exists
+ */
+export function pathExists(filePath: string): boolean {
+  try {
+    return existsSync(filePath);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get relative path from home directory for display
+ */
+export function getDisplayPath(filePath: string): string {
+  const home = getHomeDir();
+  if (filePath.startsWith(home)) {
+    return filePath.replace(home, '~');
+  }
+  return filePath;
+}
+
+/**
+ * Get MCP config file paths based on target
+ * @param target - Which config(s) to get ('cli', 'app', or 'both')
+ * @returns Object with the requested config paths
+ */
+export function getMCPConfigPaths(target: 'cli' | 'app' | 'both' = 'both'): {
+  cli?: string;
+  app?: string;
+} {
+  const result: { cli?: string; app?: string } = {};
+
+  if (target === 'cli' || target === 'both') {
+    result.cli = getClaudeCliConfigPath();
+  }
+  if (target === 'app' || target === 'both') {
+    result.app = getConfigPaths().appConfig;
+  }
+
+  return result;
+}

package/test/test.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env bun
+"use strict";
+// Test script for Claude Code Config MCP Server
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+var stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+function main() {
+    return __awaiter(this, void 0, void 0, function () {
+        var transport, client, listResult, readResult, content, paths, _i, paths_1, pathType, pathResult, data, hooksResult, hooks, error_1;
+        var _a, _b, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    console.log('Starting Claude Code Config MCP Server test...\n');
+                    transport = new stdio_js_1.StdioClientTransport({
+                        command: 'bun',
+                        args: ['run', 'src/index.ts'],
+                        cwd: '/Users/ebowwa/Desktop/codespaces/MCP/packages/claude-code-config',
+                    });
+                    client = new index_js_1.Client({ name: 'test-client', version: '1.0.0' }, { capabilities: {} });
+                    _d.label = 1;
+                case 1:
+                    _d.trys.push([1, 10, 11, 13]);
+                    // Connect to server
+                    return [4 /*yield*/, client.connect(transport)];
+                case 2:
+                    // Connect to server
+                    _d.sent();
+                    console.log('✅ Connected to server\n');
+                    // Test 1: List config files
+                    console.log('📋 Test 1: List config files');
+                    return [4 /*yield*/, client.callTool({
+                            name: 'list_config_files',
+                            arguments: { includeProject: true },
+                        })];
+                case 3:
+                    listResult = _d.sent();
+                    console.log(JSON.stringify(listResult, null, 2));
+                    console.log('');
+                    // Test 2: Read global CLAUDE.md
+                    console.log('📄 Test 2: Read global CLAUDE.md');
+                    return [4 /*yield*/, client.callTool({
+                            name: 'read_global_claude_md',
+                            arguments: {},
+                        })];
+                case 4:
+                    readResult = _d.sent();
+                    content = (_a = readResult.content[0]) === null || _a === void 0 ? void 0 : _a.text;
+                    console.log("Content preview (".concat(content.length, " chars):"));
+                    console.log(content.substring(0, 200) + '...\n');
+                    // Test 3: Get config paths
+                    console.log('🔍 Test 3: Get config paths');
+                    paths = ['CLAUDE_MD_GLOBAL', 'KEYBINDINGS', 'SETTINGS'];
+                    _i = 0, paths_1 = paths;
+                    _d.label = 5;
+                case 5:
+                    if (!(_i < paths_1.length)) return [3 /*break*/, 8];
+                    pathType = paths_1[_i];
+                    return [4 /*yield*/, client.callTool({
+                            name: 'get_config_path',
+                            arguments: { fileType: pathType },
+                        })];
+                case 6:
+                    pathResult = _d.sent();
+                    data = JSON.parse((_b = pathResult.content[0]) === null || _b === void 0 ? void 0 : _b.text);
+                    console.log("  ".concat(pathType, ": ").concat(data.path, " (exists: ").concat(data.exists, ")"));
+                    _d.label = 7;
+                case 7:
+                    _i++;
+                    return [3 /*break*/, 5];
+                case 8:
+                    console.log('');
+                    // Test 4: List hooks
+                    console.log('🪝 Test 4: List hooks');
+                    return [4 /*yield*/, client.callTool({
+                            name: 'list_hooks',
+                            arguments: {},
+                        })];
+                case 9:
+                    hooksResult = _d.sent();
+                    hooks = JSON.parse((_c = hooksResult.content[0]) === null || _c === void 0 ? void 0 : _c.text);
+                    console.log("  Found ".concat(hooks.length, " hooks"));
+                    console.log('');
+                    console.log('✅ All tests passed!');
+                    return [3 /*break*/, 13];
+                case 10:
+                    error_1 = _d.sent();
+                    console.error('❌ Test failed:', error_1);
+                    process.exit(1);
+                    return [3 /*break*/, 13];
+                case 11: return [4 /*yield*/, client.close()];
+                case 12:
+                    _d.sent();
+                    return [7 /*endfinally*/];
+                case 13: return [2 /*return*/];
+            }
+        });
+    });
+}
+main();

package/test/test.ts

@@ -0,0 +1,79 @@
+#!/usr/bin/env bun
+// Test script for Claude Code Config MCP Server
+
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+
+async function main() {
+  console.log('Starting Claude Code Config MCP Server test...\n');
+
+  // Create client
+  const transport = new StdioClientTransport({
+    command: 'bun',
+    args: ['run', 'src/index.ts'],
+    cwd: '/Users/ebowwa/Desktop/codespaces/MCP/packages/claude-code-config',
+  });
+
+  const client = new Client(
+    { name: 'test-client', version: '1.0.0' },
+    { capabilities: {} }
+  );
+
+  try {
+    // Connect to server
+    await client.connect(transport);
+    console.log('✅ Connected to server\n');
+
+    // Test 1: List config files
+    console.log('📋 Test 1: List config files');
+    const listResult = await client.callTool({
+      name: 'list_config_files',
+      arguments: { includeProject: true },
+    });
+    console.log(JSON.stringify(listResult, null, 2));
+    console.log('');
+
+    // Test 2: Read global CLAUDE.md
+    console.log('📄 Test 2: Read global CLAUDE.md');
+    const readResult = await client.callTool({
+      name: 'read_global_claude_md',
+      arguments: {},
+    });
+    const content = readResult.content[0]?.text as string;
+    console.log(`Content preview (${content.length} chars):`);
+    console.log(content.substring(0, 200) + '...\n');
+
+    // Test 3: Get config paths
+    console.log('🔍 Test 3: Get config paths');
+    const paths = ['CLAUDE_MD_GLOBAL', 'KEYBINDINGS', 'SETTINGS'] as const;
+    for (const pathType of paths) {
+      const pathResult = await client.callTool({
+        name: 'get_config_path',
+        arguments: { fileType: pathType },
+      });
+      const data = JSON.parse(pathResult.content[0]?.text as string);
+      console.log(`  ${pathType}: ${data.path} (exists: ${data.exists})`);
+    }
+    console.log('');
+
+    // Test 4: List hooks
+    console.log('🪝 Test 4: List hooks');
+    const hooksResult = await client.callTool({
+      name: 'list_hooks',
+      arguments: {},
+    });
+    const hooks = JSON.parse(hooksResult.content[0]?.text as string);
+    console.log(`  Found ${hooks.length} hooks`);
+    console.log('');
+
+    console.log('✅ All tests passed!');
+
+  } catch (error) {
+    console.error('❌ Test failed:', error);
+    process.exit(1);
+  } finally {
+    await client.close();
+  }
+}
+
+main();