Skip to main content
Glama
Isco0819

act-mcp

by Isco0819
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

act-mcp

MCP stdio server exposing three tools for running GitHub Actions locally via act.

Peer dependency: act

act must be installed and in PATH:

# macOS
brew install act

# Linux
curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

Related MCP server: AI Code Review MCP Server

MCP Tools

list_workflows

Globs .github/workflows/*.yml and returns job names from each file.

Field

Type

Description

cwd

string?

Repo root (default: process.cwd())

Returns: Array<{ file: string, jobs: string[] }>

run_job

Spawns act -j <jobName>, captures stdout+stderr, caches logs.

Field

Type

Description

jobName

string

Job ID (key under jobs: in the YAML)

cwd

string?

Repo root (default: process.cwd())

Returns: { exitCode: number, logs: string }

get_logs

Returns logs cached by the most recent run_job call.

Returns: { logs: string | null }

Agent loop

list_workflows → pick failing job
run_job        → read exitCode + logs
get_logs       → inspect failure output
(patch YAML)
run_job        → verify fix

MCP client config (Claude Desktop)

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

Or point cwd at a specific repo:

{
  "mcpServers": {
    "act-mcp": {
      "command": "npx",
      "args": ["act-mcp"],
      "env": {}
    }
  }
}

Pass cwd as a tool argument at call time:

{ "name": "list_workflows", "arguments": { "cwd": "/path/to/repo" } }

Development

npm install
npm run build   # tsc → dist/
npm test        # vitest (uses mock act binary, no act required)
npm run dev     # run via tsx without building

Environment variables

Variable

Default

Description

ACT_BIN

act

Path to the act binary (useful for testing)

Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • GitHub Actions MCP

    ArkTechNWA
    A
    license
    A
    quality
    Not graded
    maintenance
    Connects AI assistants to GitHub Actions workflows to monitor CI/CD pipelines, view run logs, diagnose failures, and optionally trigger or manage workflows with granular permission controls.
    10
    1

  • AI Code Review MCP Server

    namph-kozocom
    A
    license
    B
    quality
    D
    maintenance
    Integrates GitHub repository management and local file system access to enable AI agents to perform code reviews and manage pull requests. It provides tools for listing repositories, retrieving PR diffs, and searching or reading files within a specified workspace.
    7
    50
    MIT

  • OSOP MCP Server

    Archie0125
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to manage OSOP workflows by providing tools for validation, execution, testing, and optimization. It also supports converting workflows between OSOP and external formats like GitHub Actions, BPMN, and Airflow DAGs.
    1
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • GitHub

    Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • SentinelX MCP

    Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.

  • Hexis

    Git-backed platform for skills, tools, and context for AI agents

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Isco0819/act-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server