palan-k-mcp 0.2.0

package/README.md

@@ -0,0 +1,76 @@
+# palan-k-mcp
+
+> The Governance & Deployment Engine for Rust
+>
+> AI 코딩 어시스턴트를 위한 통합형 MCP 서버
+
+## Installation
+
+```bash
+npm install -g palan-k-mcp
+```
+
+> Platform binaries are automatically installed from `@palan-k/mcp-*` scoped packages.
+
+### Auto-configure MCP
+
+**Linux/macOS:**
+```bash
+PALAN_K_AUTO_CONFIG=true npm install -g palan-k-mcp
+```
+
+**Windows (cmd):**
+```cmd
+set PALAN_K_AUTO_CONFIG=true && npm install -g palan-k-mcp
+```
+
+**Windows (PowerShell):**
+```powershell
+$env:PALAN_K_AUTO_CONFIG="true"; npm install -g palan-k-mcp
+```
+
+## Features
+
+### Governance (코드 품질 관리)
+- `get_constitution` - 프로젝트 코딩 규칙 반환
+- `validate_code` - 코드 헌법 준수 검사
+- `scan_local_docs` - 로컬 문서 스캔
+- `ingest_url` - URL 문서 크롤링
+- `query_knowledge` - 지식 통합 검색
+
+### Deployment (배포)
+- `init_vps` - 서버 초기화
+- `ship` - 빌드 + 배포
+- `logs` - 로그 스트리밍
+- `rollback` - 이전 버전 복구
+
+## MCP Configuration
+
+Add to Claude Desktop config:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "palan-k-mcp": {
+      "command": "palan-k-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## Supported Platforms
+
+| Platform | Architecture |
+|----------|--------------|
+| Linux    | x64          |
+| macOS    | arm64 (M1/M2/M3) |
+| Windows  | x64          |
+
+## License
+
+MIT

package/bin/run.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+/**
+ * Cross-platform binary runner for palan-k-mcp
+ * Finds and executes the binary from the platform-specific package
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+function getPlatformPackage() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    const platformMap = {
+        'linux-x64': '@palan-k/mcp-linux-x64',
+        'linux-arm64': '@palan-k/mcp-linux-arm64',
+        'darwin-x64': '@palan-k/mcp-darwin-x64',
+        'darwin-arm64': '@palan-k/mcp-darwin-arm64',
+        'win32-x64': '@palan-k/mcp-win32-x64'
+    };
+
+    const key = `${platform}-${arch}`;
+    const packageName = platformMap[key];
+
+    if (!packageName) {
+        throw new Error(`Unsupported platform: ${platform}-${arch}`);
+    }
+
+    return {
+        packageName,
+        binaryName: platform === 'win32' ? 'palan-k-mcp.exe' : 'palan-k-mcp'
+    };
+}
+
+function findBinary() {
+    const { packageName, binaryName } = getPlatformPackage();
+
+    // Look for the platform package in node_modules
+    const possiblePaths = [
+        // Installed as dependency (most common)
+        path.join(__dirname, '..', 'node_modules', packageName, 'bin', binaryName),
+        // Hoisted to parent node_modules
+        path.join(__dirname, '..', '..', packageName, 'bin', binaryName),
+        // Global install
+        path.join(__dirname, '..', '..', '..', packageName, 'bin', binaryName),
+        // Fallback: same directory
+        path.join(__dirname, binaryName)
+    ];
+
+    for (const binPath of possiblePaths) {
+        if (fs.existsSync(binPath)) {
+            return binPath;
+        }
+    }
+
+    throw new Error(
+        `Binary not found for ${packageName}.\n` +
+        `Looked in:\n${possiblePaths.join('\n')}\n\n` +
+        `Try reinstalling: npm install -g palan-k-mcp`
+    );
+}
+
+function main() {
+    try {
+        const binaryPath = findBinary();
+        const args = process.argv.slice(2);
+
+        const child = spawn(binaryPath, args, {
+            stdio: 'inherit',
+            shell: false
+        });
+
+        child.on('error', (err) => {
+            console.error(`Failed to start binary: ${err.message}`);
+            process.exit(1);
+        });
+
+        child.on('exit', (code, signal) => {
+            if (signal) {
+                process.kill(process.pid, signal);
+            } else {
+                process.exit(code ?? 0);
+            }
+        });
+
+    } catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "palan-k-mcp",
+  "version": "0.2.0",
+  "description": "The Governance & Deployment Engine for Rust - AI 코딩 어시스턴트를 위한 통합형 MCP 서버",
+  "bin": {
+    "palan-k-mcp": "./bin/run.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "optionalDependencies": {
+    "@palan-k/mcp-linux-x64": "0.2.0",
+    "@palan-k/mcp-darwin-arm64": "0.2.0",
+    "@palan-k/mcp-win32-x64": "0.2.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/naegeon/palank-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "governance",
+    "deployment",
+    "rust",
+    "ai",
+    "claude"
+  ],
+  "author": "Palan-K",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "postinstall.js",
+    "README.md"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for palan-k-mcp
+ * Optionally configures MCP settings for Claude Desktop
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Skip in CI
+if (process.env.CI) {
+    process.exit(0);
+}
+
+function getPlatformPackage() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    const platformMap = {
+        'linux-x64': '@palan-k/mcp-linux-x64',
+        'linux-arm64': '@palan-k/mcp-linux-arm64',
+        'darwin-x64': '@palan-k/mcp-darwin-x64',
+        'darwin-arm64': '@palan-k/mcp-darwin-arm64',
+        'win32-x64': '@palan-k/mcp-win32-x64'
+    };
+
+    return platformMap[`${platform}-${arch}`];
+}
+
+function findBinary() {
+    const platform = os.platform();
+    const packageName = getPlatformPackage();
+    const binaryName = platform === 'win32' ? 'palan-k-mcp.exe' : 'palan-k-mcp';
+
+    if (!packageName) {
+        return null;
+    }
+
+    const possiblePaths = [
+        path.join(__dirname, 'node_modules', packageName, 'bin', binaryName),
+        path.join(__dirname, '..', packageName, 'bin', binaryName),
+        path.join(__dirname, '..', '..', packageName, 'bin', binaryName),
+    ];
+
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+
+function configureMcpSettings() {
+    const binaryPath = findBinary();
+    if (!binaryPath) {
+        console.log('Platform binary not found. MCP auto-config skipped.');
+        return;
+    }
+
+    const platform = os.platform();
+    let configPath;
+
+    if (platform === 'darwin') {
+        configPath = path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    } else if (platform === 'win32') {
+        configPath = path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    } else {
+        configPath = path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'), 'Claude', 'claude_desktop_config.json');
+    }
+
+    if (process.env.PALAN_K_AUTO_CONFIG === 'true') {
+        let config = { mcpServers: {} };
+
+        if (fs.existsSync(configPath)) {
+            try {
+                config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+                if (!config.mcpServers) config.mcpServers = {};
+            } catch (e) {
+                config = { mcpServers: {} };
+            }
+        }
+
+        config.mcpServers['palan-k-mcp'] = { command: binaryPath, args: [] };
+        fs.mkdirSync(path.dirname(configPath), { recursive: true });
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        console.log(`MCP config updated: ${configPath}`);
+    } else {
+        console.log('\npalan-k-mcp installed successfully!');
+        console.log(`Binary: ${binaryPath}`);
+        console.log('\nTo enable in Claude Desktop, add to config:');
+        console.log(JSON.stringify({
+            "mcpServers": {
+                "palan-k-mcp": { "command": binaryPath, "args": [] }
+            }
+        }, null, 2));
+        console.log(`\nConfig location: ${configPath}`);
+        console.log('Or set PALAN_K_AUTO_CONFIG=true to auto-configure.\n');
+    }
+}
+
+configureMcpSettings();