mcp-server-github-actions 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ofer Shapira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# mcp-server-github-actions
+
+[![npm version](https://img.shields.io/npm/v/mcp-server-github-actions.svg)](https://www.npmjs.com/package/mcp-server-github-actions)
+[![npm downloads](https://img.shields.io/npm/dm/mcp-server-github-actions.svg)](https://www.npmjs.com/package/mcp-server-github-actions)
+[![CI](https://github.com/ofershap/mcp-server-github-actions/actions/workflows/ci.yml/badge.svg)](https://github.com/ofershap/mcp-server-github-actions/actions/workflows/ci.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Manage GitHub Actions workflows from your AI assistant. List runs, read logs, re-run failed jobs, cancel builds, and trigger deployments without leaving your editor.
+
+```bash
+npx mcp-server-github-actions
+```
+
+> Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Requires a GitHub token with Actions permissions.
+
+![MCP server for GitHub Actions workflows, CI/CD runs, and deployment logs](assets/demo.gif)
+
+<sub>Demo built with <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a></sub>
+
+## Why
+
+GitHub's official MCP server covers repos, issues, and PRs, but it doesn't touch Actions. That means when your CI fails, you still have to open a browser, find the run, click through to the logs, and figure out what went wrong. This server fills that gap. You can ask your assistant "why did the last CI run fail?" or "re-run the failed jobs" and get answers right where you're working. It uses the same GitHub REST API you'd use manually, just without the context switching.
+
+## Tools
+
+| Tool                | Description                                                  |
+| ------------------- | ------------------------------------------------------------ |
+| `list_workflows`    | List all workflow files in a repository                      |
+| `list_runs`         | List workflow runs (optionally filter by workflow or status)  |
+| `get_run`           | Get details of a specific workflow run                       |
+| `get_run_logs`      | Get the logs URL for a run (zip file download)               |
+| `rerun_workflow`    | Re-run an entire workflow run                                |
+| `rerun_failed_jobs` | Re-run only the failed jobs from a run                       |
+| `cancel_run`        | Cancel an in-progress or queued run                          |
+| `list_artifacts`    | List artifacts produced by a workflow run                    |
+| `trigger_workflow`  | Trigger a workflow via `workflow_dispatch`                    |
+
+## Quick Start
+
+### Cursor
+
+Add to your Cursor MCP settings (e.g. `~/.cursor/mcp.json` or project-level):
+
+```json
+{
+  "mcpServers": {
+    "github-actions": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-github-actions"],
+      "env": {
+        "GITHUB_TOKEN": "<your-token>"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "github-actions": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-github-actions"],
+      "env": {
+        "GITHUB_TOKEN": "<your-token>"
+      }
+    }
+  }
+}
+```
+
+### VS Code
+
+Configure your MCP client to run:
+
+```bash
+npx mcp-server-github-actions
+```
+
+Make sure `GITHUB_TOKEN` is set in the environment (e.g. in your shell profile or client config).
+
+## Auth
+
+Create a GitHub Personal Access Token:
+
+1. **Settings** > **Developer settings** > **Personal access tokens**
+2. Choose **Fine-grained tokens** (recommended) or **Tokens (classic)**
+3. Fine-grained: select your repos, then enable **Actions: Read and Write**
+4. Classic: enable the `repo` scope (includes Actions)
+
+## Example Prompts
+
+- "List the last 5 workflow runs for ofershap/mcp-server-docker"
+- "Show me the workflows in the microsoft/vscode repo"
+- "Get details for run 12345 in owner/repo"
+- "Re-run the failed jobs for run 67890 in my-org/my-repo"
+- "Cancel the currently running workflow run 11111"
+- "List artifacts from the latest run in owner/repo"
+- "Trigger the deploy.yml workflow on the staging branch for my-org/my-app"
+- "What's the status of the most recent CI run for this project?"
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm run build
+npm test
+npm run lint
+npm run format
+```
+
+## Author
+
+**Ofer Shapira**
+
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-ofershap-blue?logo=linkedin)](https://linkedin.com/in/ofershap)
+[![GitHub](https://img.shields.io/badge/GitHub-ofershap-black?logo=github)](https://github.com/ofershap)
+
+## License
+
+MIT © 2026 Ofer Shapira

package/dist/index.js

@@ -0,0 +1,286 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/github-actions.ts
+var API_BASE = "https://api.github.com";
+async function ghFetch(token, path, options = {}) {
+  const response = await fetch(`${API_BASE}${path}`, {
+    method: options.method ?? "GET",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28",
+      ...options.body ? { "Content-Type": "application/json" } : {}
+    },
+    body: options.body ? JSON.stringify(options.body) : void 0
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`GitHub API error ${response.status}: ${text}`);
+  }
+  if (response.status === 204) return {};
+  return response.json();
+}
+async function listWorkflows(token, owner, repo) {
+  const data = await ghFetch(
+    token,
+    `/repos/${owner}/${repo}/actions/workflows`
+  );
+  return data.workflows;
+}
+async function listRuns(token, owner, repo, workflowId, status, perPage = 10) {
+  const params = new URLSearchParams({ per_page: String(perPage) });
+  if (status) params.set("status", status);
+  const path = workflowId ? `/repos/${owner}/${repo}/actions/workflows/${workflowId}/runs?${params}` : `/repos/${owner}/${repo}/actions/runs?${params}`;
+  const data = await ghFetch(token, path);
+  return data.workflow_runs;
+}
+async function getRun(token, owner, repo, runId) {
+  return ghFetch(
+    token,
+    `/repos/${owner}/${repo}/actions/runs/${runId}`
+  );
+}
+async function getRunLogs(token, owner, repo, runId) {
+  const response = await fetch(
+    `${API_BASE}/repos/${owner}/${repo}/actions/runs/${runId}/logs`,
+    {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28"
+      },
+      redirect: "follow"
+    }
+  );
+  if (!response.ok) {
+    throw new Error(
+      `GitHub API error ${response.status}: ${await response.text()}`
+    );
+  }
+  return `Logs URL: ${response.url}
+(GitHub returns a redirect to a zip file \u2014 download it to inspect logs)`;
+}
+async function rerunWorkflow(token, owner, repo, runId) {
+  await ghFetch(token, `/repos/${owner}/${repo}/actions/runs/${runId}/rerun`, {
+    method: "POST"
+  });
+  return `Workflow run ${runId} re-run triggered`;
+}
+async function rerunFailedJobs(token, owner, repo, runId) {
+  await ghFetch(
+    token,
+    `/repos/${owner}/${repo}/actions/runs/${runId}/rerun-failed-jobs`,
+    { method: "POST" }
+  );
+  return `Failed jobs for run ${runId} re-run triggered`;
+}
+async function cancelRun(token, owner, repo, runId) {
+  await ghFetch(token, `/repos/${owner}/${repo}/actions/runs/${runId}/cancel`, {
+    method: "POST"
+  });
+  return `Workflow run ${runId} cancelled`;
+}
+async function listArtifacts(token, owner, repo, runId) {
+  const data = await ghFetch(
+    token,
+    `/repos/${owner}/${repo}/actions/runs/${runId}/artifacts`
+  );
+  return data.artifacts;
+}
+async function triggerWorkflow(token, owner, repo, workflowId, ref, inputs) {
+  await ghFetch(
+    token,
+    `/repos/${owner}/${repo}/actions/workflows/${workflowId}/dispatches`,
+    {
+      method: "POST",
+      body: { ref, inputs: inputs ?? {} }
+    }
+  );
+  return `Workflow ${workflowId} triggered on ${ref}`;
+}
+
+// src/index.ts
+var server = new McpServer({
+  name: "mcp-server-github-actions",
+  version: "1.0.0"
+});
+function getToken() {
+  const token = process.env.GITHUB_TOKEN;
+  if (!token) {
+    throw new Error(
+      "GITHUB_TOKEN environment variable is required. Create a token at https://github.com/settings/tokens"
+    );
+  }
+  return token;
+}
+server.tool(
+  "list_workflows",
+  "List all workflow files in a GitHub repository.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name")
+  },
+  async ({ owner, repo }) => {
+    const token = getToken();
+    const workflows = await listWorkflows(token, owner, repo);
+    const text = workflows.length === 0 ? "No workflows found." : workflows.map((w) => `id: ${w.id}  name: ${w.name}  state: ${w.state}`).join("\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "list_runs",
+  "List workflow runs for a repository. Optionally filter by workflow or status.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    workflow_id: z.number().optional().describe("Workflow ID to filter runs (from list_workflows)"),
+    status: z.string().optional().describe("Filter by status: completed, in_progress, queued, etc."),
+    per_page: z.number().optional().default(10).describe("Number of runs to return (default 10)")
+  },
+  async ({ owner, repo, workflow_id, status, per_page }) => {
+    const token = getToken();
+    const runs = await listRuns(
+      token,
+      owner,
+      repo,
+      workflow_id,
+      status,
+      per_page
+    );
+    const text = runs.length === 0 ? "No runs found." : runs.map(
+      (r) => `#${r.run_number}  ${r.name}  status: ${r.status}  conclusion: ${r.conclusion ?? "\u2014"}  branch: ${r.head_branch}  ${r.html_url}`
+    ).join("\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "get_run",
+  "Get details of a specific workflow run.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const run = await getRun(token, owner, repo, run_id);
+    const text = [
+      `Run #${run.run_number}: ${run.name}`,
+      `Status: ${run.status}  Conclusion: ${run.conclusion ?? "\u2014"}`,
+      `Branch: ${run.head_branch}`,
+      `URL: ${run.html_url}`,
+      `Created: ${run.created_at}  Updated: ${run.updated_at}`
+    ].join("\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "get_run_logs",
+  "Get logs URL for a workflow run. GitHub returns a redirect to a zip file.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const logs = await getRunLogs(token, owner, repo, run_id);
+    return { content: [{ type: "text", text: logs }] };
+  }
+);
+server.tool(
+  "rerun_workflow",
+  "Re-run a complete workflow run.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const result = await rerunWorkflow(token, owner, repo, run_id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "rerun_failed_jobs",
+  "Re-run only the failed jobs from a workflow run.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const result = await rerunFailedJobs(token, owner, repo, run_id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "cancel_run",
+  "Cancel a workflow run that is in progress or queued.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const result = await cancelRun(token, owner, repo, run_id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "list_artifacts",
+  "List artifacts produced by a workflow run.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    run_id: z.number().describe("Workflow run ID")
+  },
+  async ({ owner, repo, run_id }) => {
+    const token = getToken();
+    const artifacts = await listArtifacts(token, owner, repo, run_id);
+    const text = artifacts.length === 0 ? "No artifacts found." : artifacts.map(
+      (a) => `name: ${a.name}  size: ${a.size_in_bytes} bytes  expired: ${a.expired ? "yes" : "no"}`
+    ).join("\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "trigger_workflow",
+  "Trigger a workflow run via workflow_dispatch. Requires a workflow with workflow_dispatch enabled.",
+  {
+    owner: z.string().describe("Repository owner (username or org)"),
+    repo: z.string().describe("Repository name"),
+    workflow_id: z.string().describe("Workflow ID or filename (e.g. ci.yml)"),
+    ref: z.string().optional().default("main").describe("Branch or tag to run on (default: main)"),
+    inputs: z.record(z.string()).optional().describe("Optional workflow inputs as key-value pairs")
+  },
+  async ({ owner, repo, workflow_id, ref, inputs }) => {
+    const token = getToken();
+    const result = await triggerWorkflow(
+      token,
+      owner,
+      repo,
+      workflow_id,
+      ref,
+      inputs
+    );
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/github-actions.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport {\n  listWorkflows,\n  listRuns,\n  getRun,\n  getRunLogs,\n  rerunWorkflow,\n  rerunFailedJobs,\n  cancelRun,\n  listArtifacts,\n  triggerWorkflow,\n} from \"./github-actions.js\";\n\nconst server = new McpServer({\n  name: \"mcp-server-github-actions\",\n  version: \"1.0.0\",\n});\n\nfunction getToken(): string {\n  const token = process.env.GITHUB_TOKEN;\n  if (!token) {\n    throw new Error(\n      \"GITHUB_TOKEN environment variable is required. Create a token at https://github.com/settings/tokens\",\n    );\n  }\n  return token;\n}\n\nserver.tool(\n  \"list_workflows\",\n  \"List all workflow files in a GitHub repository.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n  },\n  async ({ owner, repo }) => {\n    const token = getToken();\n    const workflows = await listWorkflows(token, owner, repo);\n    const text =\n      workflows.length === 0\n        ? \"No workflows found.\"\n        : workflows\n            .map((w) => `id: ${w.id}  name: ${w.name}  state: ${w.state}`)\n            .join(\"\\n\");\n    return { content: [{ type: \"text\", text }] };\n  },\n);\n\nserver.tool(\n  \"list_runs\",\n  \"List workflow runs for a repository. Optionally filter by workflow or status.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    workflow_id: z\n      .number()\n      .optional()\n      .describe(\"Workflow ID to filter runs (from list_workflows)\"),\n    status: z\n      .string()\n      .optional()\n      .describe(\"Filter by status: completed, in_progress, queued, etc.\"),\n    per_page: z\n      .number()\n      .optional()\n      .default(10)\n      .describe(\"Number of runs to return (default 10)\"),\n  },\n  async ({ owner, repo, workflow_id, status, per_page }) => {\n    const token = getToken();\n    const runs = await listRuns(\n      token,\n      owner,\n      repo,\n      workflow_id,\n      status,\n      per_page,\n    );\n    const text =\n      runs.length === 0\n        ? \"No runs found.\"\n        : runs\n            .map(\n              (r) =>\n                `#${r.run_number}  ${r.name}  status: ${r.status}  conclusion: ${r.conclusion ?? \"—\"}  branch: ${r.head_branch}  ${r.html_url}`,\n            )\n            .join(\"\\n\");\n    return { content: [{ type: \"text\", text }] };\n  },\n);\n\nserver.tool(\n  \"get_run\",\n  \"Get details of a specific workflow run.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const run = await getRun(token, owner, repo, run_id);\n    const text = [\n      `Run #${run.run_number}: ${run.name}`,\n      `Status: ${run.status}  Conclusion: ${run.conclusion ?? \"—\"}`,\n      `Branch: ${run.head_branch}`,\n      `URL: ${run.html_url}`,\n      `Created: ${run.created_at}  Updated: ${run.updated_at}`,\n    ].join(\"\\n\");\n    return { content: [{ type: \"text\", text }] };\n  },\n);\n\nserver.tool(\n  \"get_run_logs\",\n  \"Get logs URL for a workflow run. GitHub returns a redirect to a zip file.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const logs = await getRunLogs(token, owner, repo, run_id);\n    return { content: [{ type: \"text\", text: logs }] };\n  },\n);\n\nserver.tool(\n  \"rerun_workflow\",\n  \"Re-run a complete workflow run.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const result = await rerunWorkflow(token, owner, repo, run_id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"rerun_failed_jobs\",\n  \"Re-run only the failed jobs from a workflow run.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const result = await rerunFailedJobs(token, owner, repo, run_id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"cancel_run\",\n  \"Cancel a workflow run that is in progress or queued.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const result = await cancelRun(token, owner, repo, run_id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"list_artifacts\",\n  \"List artifacts produced by a workflow run.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    run_id: z.number().describe(\"Workflow run ID\"),\n  },\n  async ({ owner, repo, run_id }) => {\n    const token = getToken();\n    const artifacts = await listArtifacts(token, owner, repo, run_id);\n    const text =\n      artifacts.length === 0\n        ? \"No artifacts found.\"\n        : artifacts\n            .map(\n              (a) =>\n                `name: ${a.name}  size: ${a.size_in_bytes} bytes  expired: ${a.expired ? \"yes\" : \"no\"}`,\n            )\n            .join(\"\\n\");\n    return { content: [{ type: \"text\", text }] };\n  },\n);\n\nserver.tool(\n  \"trigger_workflow\",\n  \"Trigger a workflow run via workflow_dispatch. Requires a workflow with workflow_dispatch enabled.\",\n  {\n    owner: z.string().describe(\"Repository owner (username or org)\"),\n    repo: z.string().describe(\"Repository name\"),\n    workflow_id: z.string().describe(\"Workflow ID or filename (e.g. ci.yml)\"),\n    ref: z\n      .string()\n      .optional()\n      .default(\"main\")\n      .describe(\"Branch or tag to run on (default: main)\"),\n    inputs: z\n      .record(z.string())\n      .optional()\n      .describe(\"Optional workflow inputs as key-value pairs\"),\n  },\n  async ({ owner, repo, workflow_id, ref, inputs }) => {\n    const token = getToken();\n    const result = await triggerWorkflow(\n      token,\n      owner,\n      repo,\n      workflow_id,\n      ref,\n      inputs,\n    );\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error);\n  process.exit(1);\n});\n","const API_BASE = \"https://api.github.com\";\n\ninterface RequestOptions {\n  method?: string;\n  body?: unknown;\n}\n\nasync function ghFetch<T>(\n  token: string,\n  path: string,\n  options: RequestOptions = {},\n): Promise<T> {\n  const response = await fetch(`${API_BASE}${path}`, {\n    method: options.method ?? \"GET\",\n    headers: {\n      Authorization: `Bearer ${token}`,\n      Accept: \"application/vnd.github+json\",\n      \"X-GitHub-Api-Version\": \"2022-11-28\",\n      ...(options.body ? { \"Content-Type\": \"application/json\" } : {}),\n    },\n    body: options.body ? JSON.stringify(options.body) : undefined,\n  });\n  if (!response.ok) {\n    const text = await response.text();\n    throw new Error(`GitHub API error ${response.status}: ${text}`);\n  }\n  if (response.status === 204) return {} as T;\n  return response.json() as Promise<T>;\n}\n\nexport interface Workflow {\n  id: number;\n  name: string;\n  path: string;\n  state: string;\n}\n\nexport interface WorkflowRun {\n  id: number;\n  name: string;\n  status: string;\n  conclusion: string | null;\n  head_branch: string;\n  html_url: string;\n  created_at: string;\n  updated_at: string;\n  run_number: number;\n}\n\nexport interface Artifact {\n  id: number;\n  name: string;\n  size_in_bytes: number;\n  created_at: string;\n  expired: boolean;\n}\n\nexport async function listWorkflows(\n  token: string,\n  owner: string,\n  repo: string,\n): Promise<Workflow[]> {\n  const data = await ghFetch<{ workflows: Workflow[] }>(\n    token,\n    `/repos/${owner}/${repo}/actions/workflows`,\n  );\n  return data.workflows;\n}\n\nexport async function listRuns(\n  token: string,\n  owner: string,\n  repo: string,\n  workflowId?: number,\n  status?: string,\n  perPage = 10,\n): Promise<WorkflowRun[]> {\n  const params = new URLSearchParams({ per_page: String(perPage) });\n  if (status) params.set(\"status\", status);\n  const path = workflowId\n    ? `/repos/${owner}/${repo}/actions/workflows/${workflowId}/runs?${params}`\n    : `/repos/${owner}/${repo}/actions/runs?${params}`;\n  const data = await ghFetch<{ workflow_runs: WorkflowRun[] }>(token, path);\n  return data.workflow_runs;\n}\n\nexport async function getRun(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<WorkflowRun> {\n  return ghFetch<WorkflowRun>(\n    token,\n    `/repos/${owner}/${repo}/actions/runs/${runId}`,\n  );\n}\n\nexport async function getRunLogs(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<string> {\n  const response = await fetch(\n    `${API_BASE}/repos/${owner}/${repo}/actions/runs/${runId}/logs`,\n    {\n      headers: {\n        Authorization: `Bearer ${token}`,\n        Accept: \"application/vnd.github+json\",\n        \"X-GitHub-Api-Version\": \"2022-11-28\",\n      },\n      redirect: \"follow\",\n    },\n  );\n  if (!response.ok) {\n    throw new Error(\n      `GitHub API error ${response.status}: ${await response.text()}`,\n    );\n  }\n  return `Logs URL: ${response.url}\\n(GitHub returns a redirect to a zip file — download it to inspect logs)`;\n}\n\nexport async function rerunWorkflow(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<string> {\n  await ghFetch(token, `/repos/${owner}/${repo}/actions/runs/${runId}/rerun`, {\n    method: \"POST\",\n  });\n  return `Workflow run ${runId} re-run triggered`;\n}\n\nexport async function rerunFailedJobs(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<string> {\n  await ghFetch(\n    token,\n    `/repos/${owner}/${repo}/actions/runs/${runId}/rerun-failed-jobs`,\n    { method: \"POST\" },\n  );\n  return `Failed jobs for run ${runId} re-run triggered`;\n}\n\nexport async function cancelRun(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<string> {\n  await ghFetch(token, `/repos/${owner}/${repo}/actions/runs/${runId}/cancel`, {\n    method: \"POST\",\n  });\n  return `Workflow run ${runId} cancelled`;\n}\n\nexport async function listArtifacts(\n  token: string,\n  owner: string,\n  repo: string,\n  runId: number,\n): Promise<Artifact[]> {\n  const data = await ghFetch<{ artifacts: Artifact[] }>(\n    token,\n    `/repos/${owner}/${repo}/actions/runs/${runId}/artifacts`,\n  );\n  return data.artifacts;\n}\n\nexport async function triggerWorkflow(\n  token: string,\n  owner: string,\n  repo: string,\n  workflowId: number | string,\n  ref: string,\n  inputs?: Record<string, string>,\n): Promise<string> {\n  await ghFetch(\n    token,\n    `/repos/${owner}/${repo}/actions/workflows/${workflowId}/dispatches`,\n    {\n      method: \"POST\",\n      body: { ref, inputs: inputs ?? {} },\n    },\n  );\n  return `Workflow ${workflowId} triggered on ${ref}`;\n}\n"],"mappings":";;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AACrC,SAAS,SAAS;;;ACFlB,IAAM,WAAW;AAOjB,eAAe,QACb,OACA,MACA,UAA0B,CAAC,GACf;AACZ,QAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,GAAG,IAAI,IAAI;AAAA,IACjD,QAAQ,QAAQ,UAAU;AAAA,IAC1B,SAAS;AAAA,MACP,eAAe,UAAU,KAAK;AAAA,MAC9B,QAAQ;AAAA,MACR,wBAAwB;AAAA,MACxB,GAAI,QAAQ,OAAO,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,IAC/D;AAAA,IACA,MAAM,QAAQ,OAAO,KAAK,UAAU,QAAQ,IAAI,IAAI;AAAA,EACtD,CAAC;AACD,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,UAAM,IAAI,MAAM,oBAAoB,SAAS,MAAM,KAAK,IAAI,EAAE;AAAA,EAChE;AACA,MAAI,SAAS,WAAW,IAAK,QAAO,CAAC;AACrC,SAAO,SAAS,KAAK;AACvB;AA6BA,eAAsB,cACpB,OACA,OACA,MACqB;AACrB,QAAM,OAAO,MAAM;AAAA,IACjB;AAAA,IACA,UAAU,KAAK,IAAI,IAAI;AAAA,EACzB;AACA,SAAO,KAAK;AACd;AAEA,eAAsB,SACpB,OACA,OACA,MACA,YACA,QACA,UAAU,IACc;AACxB,QAAM,SAAS,IAAI,gBAAgB,EAAE,UAAU,OAAO,OAAO,EAAE,CAAC;AAChE,MAAI,OAAQ,QAAO,IAAI,UAAU,MAAM;AACvC,QAAM,OAAO,aACT,UAAU,KAAK,IAAI,IAAI,sBAAsB,UAAU,SAAS,MAAM,KACtE,UAAU,KAAK,IAAI,IAAI,iBAAiB,MAAM;AAClD,QAAM,OAAO,MAAM,QAA0C,OAAO,IAAI;AACxE,SAAO,KAAK;AACd;AAEA,eAAsB,OACpB,OACA,OACA,MACA,OACsB;AACtB,SAAO;AAAA,IACL;AAAA,IACA,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK;AAAA,EAC/C;AACF;AAEA,eAAsB,WACpB,OACA,OACA,MACA,OACiB;AACjB,QAAM,WAAW,MAAM;AAAA,IACrB,GAAG,QAAQ,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK;AAAA,IACxD;AAAA,MACE,SAAS;AAAA,QACP,eAAe,UAAU,KAAK;AAAA,QAC9B,QAAQ;AAAA,QACR,wBAAwB;AAAA,MAC1B;AAAA,MACA,UAAU;AAAA,IACZ;AAAA,EACF;AACA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI;AAAA,MACR,oBAAoB,SAAS,MAAM,KAAK,MAAM,SAAS,KAAK,CAAC;AAAA,IAC/D;AAAA,EACF;AACA,SAAO,aAAa,SAAS,GAAG;AAAA;AAClC;AAEA,eAAsB,cACpB,OACA,OACA,MACA,OACiB;AACjB,QAAM,QAAQ,OAAO,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK,UAAU;AAAA,IAC1E,QAAQ;AAAA,EACV,CAAC;AACD,SAAO,gBAAgB,KAAK;AAC9B;AAEA,eAAsB,gBACpB,OACA,OACA,MACA,OACiB;AACjB,QAAM;AAAA,IACJ;AAAA,IACA,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK;AAAA,IAC7C,EAAE,QAAQ,OAAO;AAAA,EACnB;AACA,SAAO,uBAAuB,KAAK;AACrC;AAEA,eAAsB,UACpB,OACA,OACA,MACA,OACiB;AACjB,QAAM,QAAQ,OAAO,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK,WAAW;AAAA,IAC3E,QAAQ;AAAA,EACV,CAAC;AACD,SAAO,gBAAgB,KAAK;AAC9B;AAEA,eAAsB,cACpB,OACA,OACA,MACA,OACqB;AACrB,QAAM,OAAO,MAAM;AAAA,IACjB;AAAA,IACA,UAAU,KAAK,IAAI,IAAI,iBAAiB,KAAK;AAAA,EAC/C;AACA,SAAO,KAAK;AACd;AAEA,eAAsB,gBACpB,OACA,OACA,MACA,YACA,KACA,QACiB;AACjB,QAAM;AAAA,IACJ;AAAA,IACA,UAAU,KAAK,IAAI,IAAI,sBAAsB,UAAU;AAAA,IACvD;AAAA,MACE,QAAQ;AAAA,MACR,MAAM,EAAE,KAAK,QAAQ,UAAU,CAAC,EAAE;AAAA,IACpC;AAAA,EACF;AACA,SAAO,YAAY,UAAU,iBAAiB,GAAG;AACnD;;;ADhLA,IAAM,SAAS,IAAI,UAAU;AAAA,EAC3B,MAAM;AAAA,EACN,SAAS;AACX,CAAC;AAED,SAAS,WAAmB;AAC1B,QAAM,QAAQ,QAAQ,IAAI;AAC1B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC7C;AAAA,EACA,OAAO,EAAE,OAAO,KAAK,MAAM;AACzB,UAAM,QAAQ,SAAS;AACvB,UAAM,YAAY,MAAM,cAAc,OAAO,OAAO,IAAI;AACxD,UAAM,OACJ,UAAU,WAAW,IACjB,wBACA,UACG,IAAI,CAAC,MAAM,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,YAAY,EAAE,KAAK,EAAE,EAC5D,KAAK,IAAI;AAClB,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAAA,EAC7C;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,aAAa,EACV,OAAO,EACP,SAAS,EACT,SAAS,kDAAkD;AAAA,IAC9D,QAAQ,EACL,OAAO,EACP,SAAS,EACT,SAAS,wDAAwD;AAAA,IACpE,UAAU,EACP,OAAO,EACP,SAAS,EACT,QAAQ,EAAE,EACV,SAAS,uCAAuC;AAAA,EACrD;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,aAAa,QAAQ,SAAS,MAAM;AACxD,UAAM,QAAQ,SAAS;AACvB,UAAM,OAAO,MAAM;AAAA,MACjB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,OACJ,KAAK,WAAW,IACZ,mBACA,KACG;AAAA,MACC,CAAC,MACC,IAAI,EAAE,UAAU,KAAK,EAAE,IAAI,aAAa,EAAE,MAAM,iBAAiB,EAAE,cAAc,QAAG,aAAa,EAAE,WAAW,KAAK,EAAE,QAAQ;AAAA,IACjI,EACC,KAAK,IAAI;AAClB,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAAA,EAC7C;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,MAAM,MAAM,OAAO,OAAO,OAAO,MAAM,MAAM;AACnD,UAAM,OAAO;AAAA,MACX,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI;AAAA,MACnC,WAAW,IAAI,MAAM,iBAAiB,IAAI,cAAc,QAAG;AAAA,MAC3D,WAAW,IAAI,WAAW;AAAA,MAC1B,QAAQ,IAAI,QAAQ;AAAA,MACpB,YAAY,IAAI,UAAU,cAAc,IAAI,UAAU;AAAA,IACxD,EAAE,KAAK,IAAI;AACX,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAAA,EAC7C;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,OAAO,MAAM,WAAW,OAAO,OAAO,MAAM,MAAM;AACxD,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,CAAC,EAAE;AAAA,EACnD;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,SAAS,MAAM,cAAc,OAAO,OAAO,MAAM,MAAM;AAC7D,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE;AAAA,EACrD;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,SAAS,MAAM,gBAAgB,OAAO,OAAO,MAAM,MAAM;AAC/D,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE;AAAA,EACrD;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,SAAS,MAAM,UAAU,OAAO,OAAO,MAAM,MAAM;AACzD,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE;AAAA,EACrD;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,QAAQ,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,EAC/C;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,OAAO,MAAM;AACjC,UAAM,QAAQ,SAAS;AACvB,UAAM,YAAY,MAAM,cAAc,OAAO,OAAO,MAAM,MAAM;AAChE,UAAM,OACJ,UAAU,WAAW,IACjB,wBACA,UACG;AAAA,MACC,CAAC,MACC,SAAS,EAAE,IAAI,WAAW,EAAE,aAAa,oBAAoB,EAAE,UAAU,QAAQ,IAAI;AAAA,IACzF,EACC,KAAK,IAAI;AAClB,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAAA,EAC7C;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,IACE,OAAO,EAAE,OAAO,EAAE,SAAS,oCAAoC;AAAA,IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,iBAAiB;AAAA,IAC3C,aAAa,EAAE,OAAO,EAAE,SAAS,uCAAuC;AAAA,IACxE,KAAK,EACF,OAAO,EACP,SAAS,EACT,QAAQ,MAAM,EACd,SAAS,yCAAyC;AAAA,IACrD,QAAQ,EACL,OAAO,EAAE,OAAO,CAAC,EACjB,SAAS,EACT,SAAS,6CAA6C;AAAA,EAC3D;AAAA,EACA,OAAO,EAAE,OAAO,MAAM,aAAa,KAAK,OAAO,MAAM;AACnD,UAAM,QAAQ,SAAS;AACvB,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAO,CAAC,EAAE;AAAA,EACrD;AACF;AAEA,eAAe,OAAO;AACpB,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAChC;AAEA,KAAK,EAAE,MAAM,CAAC,UAAU;AACtB,UAAQ,MAAM,gBAAgB,KAAK;AACnC,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "mcp-server-github-actions",
+  "version": "1.0.0",
+  "description": "MCP server for GitHub Actions — view workflow runs, read logs, re-run failed jobs, and manage CI/CD from your IDE",
+  "type": "module",
+  "bin": {
+    "mcp-server-github-actions": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . && prettier --check .",
+    "format": "prettier --write .",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "github",
+    "github-actions",
+    "ci-cd",
+    "workflows",
+    "ci",
+    "cd",
+    "ai",
+    "llm",
+    "claude",
+    "cursor"
+  ],
+  "author": "Ofer Shapira",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofershap/mcp-server-github-actions.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ofershap/mcp-server-github-actions/issues"
+  },
+  "homepage": "https://github.com/ofershap/mcp-server-github-actions#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.2.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js}": "eslint --fix",
+    "*.{json,md,yml,yaml}": "prettier --write"
+  }
+}