@iflow-mcp/shell-command-mcp 1.0.0 → 1.0.1

package/Dockerfile

@@ -1,120 +0,0 @@
-FROM ubuntu:22.04
-
-# Set non-interactive mode for apt
-ENV DEBIAN_FRONTEND=noninteractive
-ENV NODE_VERSION=22.14.0
-
-# Install basic utilities and dependencies
-RUN apt-get update && apt-get install -y \
-    tzdata \
-    curl \
-    wget \
-    git \
-    gnupg \
-    lsb-release \
-    software-properties-common \
-    apt-transport-https \
-    ca-certificates \
-    unzip \
-    zip \
-    vim \
-    nano \
-    jq \
-    netcat \
-    iputils-ping \
-    dnsutils \
-    net-tools \
-    sudo \
-    python3 \
-    python3-pip \
-    ssh \
-    openssl \
-    build-essential \
-    --no-install-recommends \
-    && apt-get clean \
-    && rm -rf /var/lib/apt/lists/*
-
-# Install Kubernetes tools
-# kubectl (latest stable version)
-RUN curl -fsSL https://dl.k8s.io/release/stable.txt \
-    | xargs -I {} curl -fsSL https://dl.k8s.io/release/{}/bin/linux/amd64/kubectl -o /usr/local/bin/kubectl \
-    && chmod +x /usr/local/bin/kubectl
-
-# helm (latest stable version)
-RUN mkdir -p /root/tmp && cd /root/tmp   \
-    && curl -fsSL https://api.github.com/repos/helm/helm/releases/latest    \
-    | jq -r '.tag_name' \
-    | xargs -I {} curl -fsSL https://get.helm.sh/helm-{}-linux-amd64.tar.gz -o helm.tar.gz \
-    && tar -zxvf helm.tar.gz \
-    && mv linux-amd64/helm /usr/local/bin/helm \
-    && cd .. && rm -rf /root/tmp
-
-# kustomize (latest stable version)
-RUN mkdir -p /root/tmp && cd /root/tmp   \
-    && curl -fsSL https://api.github.com/repos/kubernetes-sigs/kustomize/releases/latest | jq -r '.tag_name' | sed 's/kustomize\///' | xargs -I {} curl -fsSL https://github.com/kubernetes-sigs/kustomize/releases/download/kustomize%2F{}/kustomize_{}_linux_amd64.tar.gz -o kustomize.tar.gz \
-    && tar -zxvf kustomize.tar.gz \
-    && mv kustomize /usr/local/bin/ \
-    && cd .. && rm -rf /root/tmp
-
-# Install additional tools like k9s (latest stable version)
-RUN mkdir -p /root/tmp && cd /root/tmp   \
-    && curl -fsSL https://api.github.com/repos/derailed/k9s/releases/latest \
-    | jq -r '.tag_name' \
-    | xargs -I {} curl -fsSL https://github.com/derailed/k9s/releases/download/{}/k9s_Linux_amd64.tar.gz -o k9s.tar.gz \
-    && tar -zxvf k9s.tar.gz \
-    && mv k9s /usr/local/bin/ \
-    && rm k9s.tar.gz LICENSE README.md 2>/dev/null || true \
-    && cd .. && rm -rf /root/tmp
-
-# Install helmfile
-RUN mkdir -p /root/tmp && cd /root/tmp   \
-    && curl -fsSL https://github.com/helmfile/helmfile/releases/download/v0.171.0/helmfile_0.171.0_linux_amd64.tar.gz -o helmfile.tar.gz \
-    && tar -zxvf helmfile.tar.gz \
-    && mv helmfile /usr/local/bin/ \
-    && cd .. && rm -rf /root/tmp
-
-# Install sops
-RUN curl -fsSL https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.linux.amd64 -o /usr/local/bin/sops \
-    && chmod +x /usr/local/bin/sops
-
-# Install age
-RUN mkdir -p /root/tmp && cd /root/tmp   \
-    && curl -fsSL https://github.com/FiloSottile/age/releases/download/v1.2.1/age-v1.2.1-linux-amd64.tar.gz -o age.tar.gz \
-    && tar -zxvf age.tar.gz \
-    && mv age/age /usr/local/bin/ \
-    && mv age/age-keygen /usr/local/bin/ \
-    && cd .. && rm -rf /root/tmp
-
-# Node.jsのバイナリをダウンロードしてインストール
-RUN mkdir -p /root/tmp && cd /root/tmp  \
-    && ARCH=$(uname -m | sed 's/aarch64/arm64/' | sed 's/x86_64/x64/')  \
-    && curl -fsSLO --compressed "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-${ARCH}.tar.xz"   \
-    && tar -xJf "node-v${NODE_VERSION}-linux-${ARCH}.tar.xz" -C /usr/local --strip-components=1 --no-same-owner \
-    && rm "node-v${NODE_VERSION}-linux-${ARCH}.tar.xz"  \
-    && npm install -g npm@11.2.0    \
-    && ln -s /usr/local/bin/node /usr/local/bin/nodejs \
-    && cd .. && rm -rf /root/tmp
-
-WORKDIR /mcpserver
-COPY . .
-RUN npm install && npm run build 
-
-# Create a non-root user to run the MCP server
-RUN useradd -m -s /bin/bash mcp
-
-USER mcp
-RUN helm plugin install https://github.com/databus23/helm-diff  \
-    && helm plugin install https://github.com/aslafy-z/helm-git \
-    && helm plugin install https://github.com/hypnoglow/helm-s3.git \
-    && helm plugin install https://github.com/jkroepke/helm-secrets
-
-USER root
-
-# Copy default home directory contents if the home directory is empty
-RUN cp -rp /home/mcp/. /home/mcp-home-backup
-
-WORKDIR /home/mcp
-ENV WORKDIR=/home/mcp
-
-# Command to run the MCP server
-CMD ["/mcpserver/entrypoint.sh", "mcp", "node", "/mcpserver/build/index.js"]

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Nakamura Kazutaka
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/Makefile

@@ -1,8 +0,0 @@
-.PHONY: build
-
-# Docker composition
-build:
-	docker build -t shell-command-mcp .
-
-run:
-	docker run --rm -i --mount type=bind,src="$HOME/MCPHome",dst=/home/mcp shell-command-mcp

package/build/execute-bash-script-async.js

@@ -1,255 +0,0 @@
-import { z } from 'zod';
-import { spawn } from 'child_process';
-export const shellProgram = '/usr/bin/bash';
-export const toolName = 'execute-bash-script-async';
-export const toolDescription = `This tool executes shell scripts asynchronously in bash.
-Executing each command creates a new bash process.
-Synchronous execution requires to wait the scripts completed.
-Asynchronous execution makes it possible to execute multiple scripts in parallel.
-You can reduce waiting time by planning in advance which shell scripts need to be executed and executing them in parallel.
-Avoid using execute-bash-script-sync tool unless you really need to, and use this execute-bash-script-async tool whenever possible.
-`;
-export const toolOptionsDefaults = {
-    outPutMode: 'complete',
-};
-export const toolOptionsSchema = {
-    command: z.string().describe('The bash script to execute'),
-    options: z.object({
-        cwd: z.string().optional().describe(`The working directory to execute the script.
-use this option argument to avoid cd command in the first line of the script.
-\`~\` and environment variable is not supported. use absolute path instead.
-`),
-        env: z.record(z.string(), z.string()).optional()
-            .describe(`The environment variables for the script.
-      Set environment variables using this option instead of using export command in the script.
-      `),
-        timeout: z.number().int().positive().optional().describe(`The timeout in milliseconds.
-Set enough long timeout even if you don't need to set timeout to avoid unexpected blocking.
-`),
-        outputMode: z
-            .enum(['complete', 'line', 'character', 'chunk'])
-            .optional()
-            .default(toolOptionsDefaults.outPutMode).describe(`The output mode for the script.
-- complete: Notify when the command is completed
-- line: Notify on each line of output
-- chunk: Notify on each chunk of output
-- character: Notify on each character of output
-`),
-    }),
-};
-/**
- * シェルスクリプト出力ハンドリング関数
- */
-function handleOutput(chunk, isStderr, outputMode, onOutput, buffer) {
-    if (onOutput) {
-        if (outputMode === 'character') {
-            // 文字ごとに通知
-            for (const char of chunk) {
-                onOutput(char, isStderr);
-            }
-        }
-        else if (outputMode === 'line') {
-            // 行ごとに通知
-            buffer.current += chunk;
-            const lines = buffer.current.split('\n'); // 改行で分割
-            const lastLine = lines.pop(); // 最後の行を取得
-            for (const line of lines) {
-                onOutput(line + '\n', isStderr); // 改行を追加して通知
-            }
-            if (lastLine !== undefined && chunk.endsWith('\n')) {
-                // 最後のデータが改行で終わっている場合は通知
-                onOutput(lastLine + '\n', isStderr);
-                buffer.current = ''; // バッファをクリア
-            }
-            else {
-                // 最後のデータが改行で終わっていない場合は、バッファに保持
-                buffer.current = lastLine || ''; // 未完成の行を保持
-            }
-        }
-        else if (outputMode === 'chunk') {
-            // チャンク（データ受信単位）ごとに通知
-            onOutput(chunk, isStderr);
-        }
-        else if (outputMode === 'complete') {
-            // complete モードでは通知なし
-            buffer.current += chunk;
-        }
-        else {
-            // 想定外の outputMode の場合に例外をスロー
-            throw new Error(`Unsupported outputMode: ${outputMode}`);
-        }
-    }
-}
-/**
- * 柔軟な出力モードをサポートするコマンド実行関数
- */
-export async function executeCommand(command, options = {}) {
-    const outputMode = options.outputMode || toolOptionsDefaults.outPutMode;
-    const onOutput = options.onOutput;
-    return new Promise((resolve, reject) => {
-        // 環境変数を設定
-        const env = {
-            ...process.env,
-            ...options.env,
-        };
-        // bashプロセスを起動
-        const bash = spawn(shellProgram, [], {
-            cwd: options.cwd,
-            env,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
-        const stdoutBuffer = { current: '' }; // バッファのコピーを回避
-        const stderrBuffer = { current: '' }; // バッファのコピーを回避
-        let timeoutId = null;
-        const flushBuffer = () => {
-            if (onOutput) {
-                if (stdoutBuffer.current) {
-                    onOutput(stdoutBuffer.current, false);
-                    stdoutBuffer.current = ''; // バッファをクリア
-                }
-                if (stderrBuffer.current) {
-                    onOutput(stderrBuffer.current, true);
-                    stderrBuffer.current = ''; // バッファをクリア
-                }
-            }
-        };
-        // 標準出力の処理
-        bash.stdout.on('data', (data) => {
-            handleOutput(data.toString(), false, outputMode, onOutput, stdoutBuffer);
-        });
-        // 標準エラー出力の処理
-        bash.stderr.on('data', (data) => {
-            handleOutput(data.toString(), true, outputMode, onOutput, stderrBuffer);
-        });
-        // タイムアウト処理
-        if (options.timeout) {
-            timeoutId = setTimeout(() => {
-                bash.kill();
-                reject(new Error(`Command timed out after ${options.timeout}ms`));
-            }, options.timeout);
-        }
-        // プロセス終了時の処理
-        bash.on('close', (code) => {
-            // タイマーをクリア
-            if (timeoutId)
-                clearTimeout(timeoutId);
-            // バッファをフラッシュ
-            flushBuffer();
-            // NOTE これは MCP サーバの実装であるので、ログは標準エラー出力に出す
-            console.error('bash process exited with code', code);
-            resolve({
-                exitCode: code !== null ? code : 1,
-            });
-        });
-        bash.on('error', (error) => {
-            // タイマーをクリア
-            if (timeoutId)
-                clearTimeout(timeoutId);
-            // バッファをフラッシュ
-            flushBuffer();
-            // NOTE これは MCP サーバの実装であるので、ログは標準エラー出力に出す
-            console.error('Failed to start bash process:', error);
-            reject(error);
-        });
-        // コマンドを標準入力に書き込み、EOF を送信
-        bash.stdin.write(command + '\n');
-        bash.stdin.end();
-    });
-}
-// MCPサーバーにコマンド実行ツールを追加する関数
-export function setTool(mcpServer) {
-    // McpServerインスタンスから低レベルのServerインスタンスにアクセスする
-    const server = mcpServer.server;
-    // 単一のツールとして登録
-    mcpServer.tool(toolName, toolDescription, toolOptionsSchema, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async ({ command, options = {} }, extra) => {
-        try {
-            // outputModeを取得、デフォルト値は'complete'
-            const outputMode = options?.outputMode || 'complete';
-            // 進捗トークンを生成
-            const progressToken = `cmd-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
-            const onOutput = (data, isStderr) => {
-                const fsMark = isStderr ? 'stderr' : 'stdout';
-                server.notification({
-                    method: 'notifications/tools/progress',
-                    params: {
-                        progressToken,
-                        result: {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: `${fsMark}: ${data}`,
-                                },
-                            ],
-                            isComplete: false,
-                        },
-                    },
-                });
-            };
-            // バックグラウンドでコマンドを実行
-            executeCommand(command, {
-                ...options,
-                onOutput,
-            })
-                .then(({ exitCode }) => {
-                // 完了通知を送信
-                server.notification({
-                    method: 'notifications/tools/progress',
-                    params: {
-                        progressToken,
-                        result: {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: `exitCode: ${exitCode}`,
-                                },
-                            ],
-                            isComplete: true,
-                        },
-                    },
-                });
-            })
-                .catch((error) => {
-                // エラー通知を送信
-                server.notification({
-                    method: 'notifications/tools/progress',
-                    params: {
-                        progressToken,
-                        result: {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                                },
-                            ],
-                            isComplete: true,
-                            isError: true,
-                        },
-                    },
-                });
-            });
-            // 初期レスポンスを返す
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `# Command execution started with output mode, ${outputMode}`,
-                    },
-                ],
-                progressToken,
-            };
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-}

package/build/execute-bash-script-sync.js

@@ -1,111 +0,0 @@
-import { z } from 'zod';
-import { spawn } from 'child_process';
-export const shellProgram = '/usr/bin/bash';
-export const toolName = 'execute-bash-script-sync';
-export const toolDescription = `This tool executes shell scripts synchronously in bash.
-Executing each command creates a new bash process.
-Synchronous execution requires to wait the scripts completed.
-Asynchronous execution makes it possible to execute multiple scripts in parallel.
-You can reduce waiting time by planning in advance which shell scripts need to be executed and executing them in parallel.
-Avoid using this execute-bash-script-sync tool unless you really need to, and use the execute-bash-script-async tool whenever possible.
-`;
-export const toolOptionsSchema = {
-    command: z.string().describe('The bash script to execute'),
-    options: z.object({
-        cwd: z.string().optional().describe(`The working directory to execute the script.
-use this option argument to avoid cd command in the first line of the script.
-\`~\` and environment variable is not supported. use absolute path instead.
-`),
-        env: z.record(z.string(), z.string()).optional()
-            .describe(`The environment variables for the script.
-Set environment variables using this option instead of using export command in the script.
-`),
-        timeout: z.number().int().positive().optional().describe(`The timeout in milliseconds.
-Set enough long timeout even if you don't need to set timeout to avoid unexpected blocking.
-`),
-    }),
-};
-/**
- * Execute a command using bash and return the result
- *
- * Each command execution spawn a new bash process.
- * This implementation causes overhead but is simple and isolated.
- */
-export async function executeCommand(command, options = {}) {
-    return new Promise((resolve, reject) => {
-        // 環境変数を設定
-        const env = {
-            ...process.env,
-            ...options.env,
-        };
-        // bashプロセスを起動
-        const bash = spawn(shellProgram, [], {
-            cwd: options.cwd,
-            env,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
-        let stdout = '';
-        let stderr = '';
-        let timeoutId = null;
-        // 標準出力の収集
-        bash.stdout.on('data', (data) => {
-            stdout += data.toString();
-        });
-        // 標準エラー出力の収集
-        bash.stderr.on('data', (data) => {
-            stderr += data.toString();
-        });
-        // タイムアウト処理
-        if (options.timeout) {
-            timeoutId = setTimeout(() => {
-                bash.kill();
-                reject(new Error(`Command timed out after ${options.timeout}ms`));
-            }, options.timeout);
-        }
-        // プロセス終了時の処理
-        bash.on('close', (code) => {
-            if (timeoutId)
-                clearTimeout(timeoutId);
-            console.error('bash process exited with code', code);
-            resolve({
-                stdout,
-                stderr,
-                exitCode: code !== null ? code : 1,
-            });
-        });
-        bash.on('error', (error) => {
-            if (timeoutId)
-                clearTimeout(timeoutId);
-            console.error('Failed to start bash process:', error);
-            reject(error);
-        });
-        // コマンドを標準入力に書き込み、EOF を送信
-        bash.stdin.write(command + '\n');
-        bash.stdin.end();
-    });
-}
-// Execute a shell command
-export function setTool(server) {
-    server.tool(toolName, toolDescription, toolOptionsSchema, async ({ command, options }) => {
-        const { stdout, stderr, exitCode } = await executeCommand(command, options);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `stdout: ${stdout}`,
-                    resource: undefined,
-                },
-                {
-                    type: 'text',
-                    text: `stderr: ${stderr}`,
-                    resource: undefined,
-                },
-                {
-                    type: 'text',
-                    text: `exitCode: ${exitCode}`,
-                    resource: undefined,
-                },
-            ],
-        };
-    });
-}

package/build/index.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { setTool as setSyncTool } from './execute-bash-script-sync.js';
-import { setTool as setAsyncTool } from './execute-bash-script-async.js';
-// Create an MCP server
-export const server = new McpServer({
-    name: 'shell-command-mcp',
-    // TODO change to llm-workspace or something
-    version: '1.0.0',
-});
-setSyncTool(server);
-setAsyncTool(server);
-async function main() {
-    try {
-        // Start receiving messages on stdin and sending messages on stdout
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        console.error('Shell Command MCP Server started');
-    }
-    catch (error) {
-        console.error('Fatal error starting server:', error);
-        process.exit(1);
-    }
-}
-main();

package/client-sequence-example.json

@@ -1,9 +0,0 @@
-{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
-{"method":"notifications/initialized","jsonrpc":"2.0"}
-{"method":"resources/list","params":{},"jsonrpc":"2.0","id":1}
-{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}
-{"method":"prompts/list","params":{},"jsonrpc":"2.0","id":3}
-{"method":"tools/call","params":{"name":"execute-bash-script-sync","arguments":{"command":"echo \"現在の日時: $(date)\"","options":{"cwd":"/home/mcp","timeout":5000,"outputMode":"complete"}}},"jsonrpc":"2.0","id":4}
-{"method":"tools/call","params":{"name":"execute-bash-script-async","arguments":{"command":"echo \"現在の日時: $(date)\"","options":{"cwd":"/home/mcp","timeout":5000,"outputMode":"complete"}}},"jsonrpc":"2.0","id":5}
-{"method":"tools/call","params":{"name":"execute-bash-script-sync","arguments":{"command":"ls","options":{"cwd":"/home/mcp","timeout":5000,"outputMode":"complete"}}},"jsonrpc":"2.0","id":6}
-{"method":"tools/call","params":{"name":"execute-bash-script-async","arguments":{"command":"ls","options":{"cwd":"/home/mcp","timeout":5000,"outputMode":"complete"}}},"jsonrpc":"2.0","id":7}

package/docker-compose.yaml

@@ -1,17 +0,0 @@
-# version属性は廃止されたので削除
-services:
-  mcp-server:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    volumes:
-      - ./src:/home/mcp/app/src
-      - home-volume:/home/mcp
-    environment:
-      - NODE_ENV=production
-    restart: unless-stopped
-    stdin_open: true
-    tty: true
-
-volumes:
-  home-volume:

package/entrypoint.sh

@@ -1,31 +0,0 @@
-#!/bin/bash
-
-export USER=${1}
-shift
-export HOME=/home/$USER
-
-# WORKDIR の uid と gid を調べる
-uid=$(stat -c "%u" $WORKDIR)
-gid=$(stat -c "%g" $WORKDIR)
-
-if [ "$uid" -ne 0 ]; then
-    if [ "$(id -g $USER)" -ne $gid ]; then
-        # ユーザーの gid とカレントディレクトリの gid が異なる場合、
-        # ユーザーの gid をカレントディレクトリの gid に変更し、ホームディレクトリの gid も正常化する。
-        getent group $gid >/dev/null 2>&1 || groupmod -g $gid $USER
-        chgrp -R $gid $HOME
-    fi
-    if [ "$(id -u $USER)" -ne $uid ]; then
-        # ユーザーの uid とカレントディレクトリの uid が異なる場合、
-        # ユーザーの uid をカレントディレクトリの uid に変更する。
-        # ホームディレクトリは usermod によって正常化される。
-        usermod -u $uid $USER
-    fi
-fi
-
-if [ -z "$(find "$HOME" -mindepth 1 -print -quit)" ]; then
-    cp -rp /home/mcp-home-backup/. $HOME
-fi
-
-# このスクリプト自体は root で実行されているので、uid/gid 調整済みのユーザーとして指定されたコマンドを実行する。
-exec setpriv --reuid=$USER --regid=$USER --init-groups "$@"