Miyabi MCP Bundle

Provides an all-in-one MCP server for Claude Desktop with tools, agents, skills, and secure, zero-config operation.

typescript

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shunsukehayashi-miyabi-mcp-bundle": {
      "command": "npx",
      "args": [
        "-y",
        "miyabi-mcp-bundle"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "MIYABI_LOG_DIR": "/path/to/logs",
        "MIYABI_REPO_PATH": "/path/to/your/repo",
        "MIYABI_WATCH_DIR": "/path/to/watch",
        "GITHUB_DEFAULT_REPO": "your-repo",
        "GITHUB_DEFAULT_OWNER": "your-org"
      }
    }
  }
}

You can run Miyabi MCP Bundle to turn Claude Desktop into a powerful, secure MCP server that exposes a wide range of tools, agents, and plugins for automated development and monitoring. It provides zero-config setup, enterprise-grade security, intelligent caching, health checks, and cross-platform compatibility, so you can accelerate your Claude-based workflows with confidence.

How to use

You interact with the MCP server through your Claude Desktop setup. After you configure Miyabi MCP Bundle, Claude Desktop will communicate with the MCP endpoints to run tools, fetch data, and orchestrate agents and plugins. Use the built-in commands and natural language prompts to request system information, code-related actions, repository insights, and GitHub operations. Typical tasks include inspecting git status, viewing resource health, scanning logs, checking Claude Desktop health, and listing GitHub issues or PRs. The server routes each request to the appropriate tool or agent, returning structured results you can act on.

How to install

Prerequisites you need before installing: Node.js (with npm) or a compatible runtime, and a Claude Desktop installation to connect to the MCP server.

Install the Miyabi MCP Bundle globally. Run the following command in your terminal:

npm install -g miyabi-mcp-bundle

Start the interactive setup wizard to configure an MCP connection for Claude Desktop. Run:

miyabi-mcp init

If you prefer diagnose setup issues or view system information, you can use these commands:

miyabi-mcp doctor

miyabi-mcp info

Configuration and startup options

You can connect Claude Desktop to Miyabi MCP Bundle using a local MCP server configuration. The recommended approach is to run the MCP bundle via a shell command and point Claude Desktop to the running config.

Example configuration for Claude Desktop (stdio connection) is shown here. This runs the MCP bundle via npx and passes the repository path and GitHub token as environment variables.

{
  "mcpServers": {
    "miyabi": {
      "command": "npx",
      "args": ["-y", "miyabi-mcp-bundle"],
      "env": {
        "MIYABI_REPO_PATH": "/path/to/your/repo",
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Notes on environment and startup

Environment variables control repository location, logging, and GitHub access. You can customize these values to fit your environment. The following variables are shown in the configuration example and can be adjusted as needed.

Additional guidance

If you need to adjust paths or tokens, update the MIYABI_REPO_PATH and GITHUB_TOKEN values in your Claude Desktop config and restart the MCP server through Claude Desktop or the terminal using the same startup command.

Available tools

git_status

Get current git status including modified, staged, and untracked files

health_check

Run a comprehensive system health validation covering connectivity, resources, and MCP state

claude_status

Query Claude Desktop status and MCP server health

docker_ps

List Docker containers and their status (running or all)

log_search

Search log files for a given pattern and return matching entries

network_interfaces

List network interfaces and their configurations

resource_cpu

Get current CPU usage and load

process_list

List running processes and their resource usage

github_list_issues

List GitHub issues for a repository

health_check

System health validation

file_tree

Get directory tree of a path

tmux_list_sessions

List all active tmux sessions

claude_logs

Retrieve Claude Desktop logs

docker_logs

Fetch logs for a Docker container

db_health

Check status and health of configured databases

k8s_get_pods

List Kubernetes pods in a cluster

speckit_status

Get Spec-Kit project status

Built by

VeilStrat

AI signals for GTM teams