GitHub Actions Toolkit MCP Server

This project provides a Model-Context Protocol (MCP) server that acts as a bridge between an AI agent and the GitHub Actions runtime.

It wraps the official @actions/core toolkit, exposing its functions as simple, structured tools. Instead of generating and executing code, an AI agent running in a workflow can make tool calls to:

• Log debug, info, warning, and error messages
• Create annotations
• Generate job summaries

This creates a robust and secure interface, enabling AI agents to safely and effectively automate tasks within your CI/CD pipeline.

📝 MCP Client Configuration

Claude Desktop / Cline

Add this to your MCP settings configuration file:

{
  "mcpServers": {
    "actions-toolkit-mcp": {
      "command": "npx",
      "args": ["-y", "actions-toolkit-mcp"]
    }
  }
}

GitHub Copilot CLI

Add this to your Copilot configuration:

{
  "mcpServers": {
    "actions-toolkit": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "actions-toolkit-mcp"],
      "tools": ["*"]
    }
  }
}

🛠️ Development

Build

npm run build

Test Locally

node build/index.js

📦 Publishing

Before publishing to npm, ensure you:

1. Update the version in package.json
2. Build the project: npm run build
3. Publish: npm publish

The prepublishOnly script will automatically build before publishing.

📄 License

MIT