MCP 도구와 쉘 스크립트를 노출하는 MCP 서버

한국어

개요

MCP 도구로 YAML 파일에 정의된 명령을 게시하는 MCP 서버. 구성 파일에 정의하여 MCP 클라이언트의 임의 쉘 스크립트를 실행할 수 있습니다.

설치

# # # npx

Claude 부호:

존:

구성

$XDG_CONFIG_HOME/any-script-mcp/config.yaml] (일반적으로 ~/.config/any-script-mcp/config.yaml)에서 설정 파일을 만듭니다.

ANY_SCRIPT_MCP_CONFIG] 환경 변수를 사용하여 사용자 지정 구성 파일 경로도 지정할 수 있습니다:

여러 구성 파일을 지정할 때:

• 모든 파일에서 모든 도구는 단일 컬렉션에 병합됩니다.
• 같은 도구 이름이 여러 파일에 나타나면, 첫 번째 발생률이 우선합니다.
• 적어도 1개의 유효한 윤곽 파일은 성공적으로 적재되어야 합니다
• Project-specific 또는 개인 사용자 정의에서 공통 도구 분리에 유용합니다.

설정 테스트

MCP Inspector를 사용하여 구성을 테스트 할 수 있습니다.

웹 인터페이스를 열어 등록 도구를 볼 수 있으며 대화형으로 테스트 할 수 있습니다.

예제 구성

구성 형식

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