MCP ツールとして任意の CLI ツールとシェルスクリプトを公開する MCP サーバー

日本語版

概要

MCP ツールとして YAML ファイルに定義されたコマンドを公開する MCP サーバー。 設定ファイルでツールを定義することで、MCP クライアントから任意のシェルスクリプトを実行できます。

インストール

##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ###npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ##npx ## ## ## ##npx #npx ## ##npx ##npx ## ##npx ##npx ## ## ##npx #npx ## ## ## ## ## ##npx #npx ## #npx ## ## ## ## ## ## ## ## ## #npx #npx #npx ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## #npx #npx #npx ## ## ## ## ## ## #npx ## ## ## ## ## ## ## ## ##

クロード コード:

json:

設定

[$XDG_CONFIG_HOME/any-script-mcp/config.yaml で設定ファイルを作成します(通常~/.config/any-script-mcp/config.yaml])。

[ANY_SCRIPT_MCP_CONFIG]環境変数を使用してカスタム設定ファイルパスを指定することもできます。

複数の設定ファイルが指定される場合:

• すべてのファイルからのすべてのツールが単一のコレクションに統合されます
• 複数のファイルで同じツール名が表示された場合、最初の発生は優先されます
• 少なくとも1つの有効な構成ファイルは首尾よく荷を積まれなければなりません
• これは、プロジェクト固有のまたは個人的なカスタマイズから一般的なツールを分離するのに便利です

設定のテスト

MCP のインスペクタを使用して設定をテストできます。

これは、登録したツールを表示し、インタラクティブにテストできるWebインターフェイスを開きます。

設定例

設定形式

any-script-mcp

An MCP server that exposes arbitrary CLI tools and shell scripts as MCP Tools

日本語版

Overview

An MCP server that publishes commands defined in YAML files as MCP Tools. By defining tools in a configuration file, you can execute arbitrary shell scripts from MCP clients.

Installation

npx

Claude Code:

$ claude mcp add any-script \
  -s user \
  -- npx any-script-mcp

json:

{
  "mcpServers": {
     "any-script": {
       "command": "npx",
       "args": ["any-script-mcp"]
     }
  }
}

Configuration

Create a configuration file at $XDG_CONFIG_HOME/any-script-mcp/config.yaml (typically ~/.config/any-script-mcp/config.yaml).

You can also specify custom configuration file paths using the ANY_SCRIPT_MCP_CONFIG environment variable:

# Single configuration file
$ ANY_SCRIPT_MCP_CONFIG=/path/to/custom/config.yaml npx any-script-mcp

# Multiple configuration files (Unix/macOS - separated by colon)
$ ANY_SCRIPT_MCP_CONFIG=/path/to/custom.yaml:$XDG_CONFIG_HOME/any-script-mcp/config.yaml npx any-script-mcp

# Multiple configuration files (Windows - separated by semicolon)
$ ANY_SCRIPT_MCP_CONFIG=C:\path\to\custom.yaml;%APPDATA%\any-script-mcp\config.yaml npx any-script-mcp

When multiple configuration files are specified:

• All tools from all files are merged into a single collection
• If the same tool name appears in multiple files, the first occurrence takes precedence
• At least one valid configuration file must be successfully loaded
• This is useful for separating common tools from project-specific or personal customizations

Testing Your Configuration

You can test your configuration using the MCP Inspector:

$ npx @modelcontextprotocol/inspector npx any-script-mcp

This will open a web interface where you can see your registered tools and test them interactively.

Example Configuration

# yaml-language-server: $schema=https://raw.githubusercontent.com/izumin5210/any-script-mcp/main/config.schema.json
tools:
  - name: echo
    description: Echo a message
    inputs:
      message:
        type: string
        description: Message to echo
    run: |
      echo "Received: $INPUTS__MESSAGE"
      
  - name: git_status
    description: Check git status with optional branch
    inputs:
      branch-name:
        type: string
        description: Branch to check out
        required: false
      verbose:
        type: boolean
        description: Show verbose output
        default: false
    run: |
      if [ -n "${INPUTS__BRANCH_NAME:-}" ]; then
        git checkout "$INPUTS__BRANCH_NAME"
      fi
      
      if [ "$INPUTS__VERBOSE" = "true" ]; then
        git status -v
      else
        git status
      fi