Сервер MCP, который предоставляет произвольные инструменты CLI и скрипты оболочки в качестве инструментов MCP

Обзор

Сервер MCP, который публикует команды, определенные в файлах YAML как MCP Tools. Определяя инструменты в конфигурационном файле, вы можете выполнять произвольные скрипты оболочки от клиентов MCP.

##Установка

npx

Клод Код:

Джексон:

Конфигурация

Создайте файл конфигурации в $XDG_CONFIG_HOME/any-script-mcp/config.yaml (обычно ~/.config/any-script-mcp/config.yaml).

Вы также можете указать пользовательские пути конфигурации файлов, используя переменную среды ANY_SCRIPT_MCP_CONFIG:

Если указано несколько конфигурационных файлов: Все инструменты из всех файлов объединяются в единую коллекцию Если одно и то же имя инструмента появляется в нескольких файлах, первое появление имеет приоритет. По крайней мере один действительный файл конфигурации должен быть успешно загружен. Это полезно для отделения общих инструментов от конкретных проектов или личных настроек.

###Проверка конфигурации

Вы можете проверить свою конфигурацию с помощью 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