adoptai-mcp 1.0.0

package/dist/integrations/github-checks/tools.js

@@ -0,0 +1,607 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-checks';
+
+function handleError(err) {
+  const status = err.response?.status;
+  const msg = err.response?.data?.message || err.response?.data?.error || err.message;
+  if (status === 401) throw new Error(`Token invalid.\nRun: npx adoptai-${APP_ID}-mcp --client cursor`);
+  if (status === 403) throw new Error('Insufficient permissions. Check your API key scopes.');
+  if (status === 404) throw new Error('Resource not found. Check your parameters.');
+  if (status === 429) throw new Error('Rate limit exceeded. Please wait and try again.');
+  throw new Error(msg || 'API request failed');
+}
+
+async function apiRequest(method, pathTemplate, params = {}, opts = {}) {
+  const { deleteSendsJsonBody = false } = opts;
+  const headers = buildAuthHeaders();
+  let url = BASE_URL + pathTemplate;
+  const pathKeys = [...pathTemplate.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+  for (const key of pathKeys) {
+    const value = params[key];
+    if (value !== undefined && value !== null) url = url.replace(`{${key}}`, encodeURIComponent(String(value)));
+  }
+  const rest = { ...params };
+  for (const key of pathKeys) delete rest[key];
+  const m = method.toUpperCase();
+  const useQuery = m === 'GET' || (m === 'DELETE' && !deleteSendsJsonBody);
+  const queryParams = {};
+  const bodyParams = {};
+  for (const [key, value] of Object.entries(rest)) {
+    if (value === undefined) continue;
+    if (useQuery) queryParams[key] = value; else bodyParams[key] = value;
+  }
+  try {
+    const res = await axios({
+      method: m,
+      url,
+      headers: { 'Content-Type': 'application/json', ...headers },
+      params: Object.keys(queryParams).length ? queryParams : undefined,
+      data: Object.keys(bodyParams).length ? bodyParams : undefined,
+      timeout: 30000,
+    });
+    if (res.status === 204 || res.data === '' || res.data === undefined) return { ok: true, status: res.status };
+    return res.data;
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+const ENDPOINTS = [
+  {
+    "name": "checks_create",
+    "description": "Create a check run",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/check-runs",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the check. For example, \"code-coverage\"."
+        },
+        "head_sha": {
+          "type": "string",
+          "description": "The SHA of the commit."
+        },
+        "details_url": {
+          "type": "string",
+          "description": "The URL of the integrator's site that has the full details of the check. If the integrator does not provide this, then the homepage of the GitHub app is used."
+        },
+        "external_id": {
+          "type": "string",
+          "description": "A reference for the run on the integrator's system."
+        },
+        "status": {
+          "type": "string",
+          "description": "The current status of the check run. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`.",
+          "enum": [
+            "queued",
+            "in_progress",
+            "completed",
+            "waiting",
+            "requested",
+            "pending"
+          ]
+        },
+        "started_at": {
+          "type": "string",
+          "description": "The time that the check run began. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "conclusion": {
+          "type": "string",
+          "description": "**Required if you provide `completed_at` or a `status` of `completed`**. The final conclusion of the check. \n**Note:** Providing `conclusion` will automatically set the `status` parameter to `completed`. You cannot change a check run conclusion to `stale`, only GitHub can set this.",
+          "enum": [
+            "action_required",
+            "cancelled",
+            "failure",
+            "neutral",
+            "success",
+            "skipped",
+            "stale",
+            "timed_out"
+          ]
+        },
+        "completed_at": {
+          "type": "string",
+          "description": "The time the check completed. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "output": {
+          "type": "object",
+          "description": "Check runs can accept a variety of data in the `output` object, including a `title` and `summary` and can optionally provide descriptive details about the run."
+        },
+        "actions": {
+          "type": "array",
+          "description": "Displays a button on GitHub that can be clicked to alert your app to do additional tasks. For example, a code linting app can display a button that automatically fixes detected errors. The button created in this object is displayed after the check run completes. When a user clicks the button, GitHub sends the [`check_run.requested_action` webhook](https://docs.github.com/webhooks/event-payloads/#check_run) to your app. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/guides/using-the-rest-api-to-interact-with-checks#check-runs-and-requested-actions).\""
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "name",
+        "head_sha"
+      ]
+    }
+  },
+  {
+    "name": "checks_get",
+    "description": "Get a check run",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/check-runs/{check_run_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_run_id": {
+          "type": "number",
+          "description": "The unique identifier of the check run."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_run_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_update",
+    "description": "Update a check run",
+    "method": "PATCH",
+    "path": "/repos/{owner}/{repo}/check-runs/{check_run_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_run_id": {
+          "type": "number",
+          "description": "The unique identifier of the check run."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the check. For example, \"code-coverage\"."
+        },
+        "details_url": {
+          "type": "string",
+          "description": "The URL of the integrator's site that has the full details of the check."
+        },
+        "external_id": {
+          "type": "string",
+          "description": "A reference for the run on the integrator's system."
+        },
+        "started_at": {
+          "type": "string",
+          "description": "This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "status": {
+          "type": "string",
+          "description": "The current status of the check run. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`.",
+          "enum": [
+            "queued",
+            "in_progress",
+            "completed",
+            "waiting",
+            "requested",
+            "pending"
+          ]
+        },
+        "conclusion": {
+          "type": "string",
+          "description": "**Required if you provide `completed_at` or a `status` of `completed`**. The final conclusion of the check. \n**Note:** Providing `conclusion` will automatically set the `status` parameter to `completed`. You cannot change a check run conclusion to `stale`, only GitHub can set this.",
+          "enum": [
+            "action_required",
+            "cancelled",
+            "failure",
+            "neutral",
+            "success",
+            "skipped",
+            "stale",
+            "timed_out"
+          ]
+        },
+        "completed_at": {
+          "type": "string",
+          "description": "The time the check completed. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "output": {
+          "type": "object",
+          "description": "Check runs can accept a variety of data in the `output` object, including a `title` and `summary` and can optionally provide descriptive details about the run."
+        },
+        "actions": {
+          "type": "array",
+          "description": "Possible further actions the integrator can perform, which a user may trigger. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/guides/using-the-rest-api-to-interact-with-checks#check-runs-and-requested-actions).\""
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_run_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_list_annotations",
+    "description": "List check run annotations",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/check-runs/{check_run_id}/annotations",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_run_id": {
+          "type": "number",
+          "description": "The unique identifier of the check run."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_run_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_rerequest_run",
+    "description": "Rerequest a check run",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_run_id": {
+          "type": "number",
+          "description": "The unique identifier of the check run."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_run_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_create_suite",
+    "description": "Create a check suite",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/check-suites",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "head_sha": {
+          "type": "string",
+          "description": "The sha of the head commit."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "head_sha"
+      ]
+    }
+  },
+  {
+    "name": "checks_set_suites_preferences",
+    "description": "Update repository preferences for check suites",
+    "method": "PATCH",
+    "path": "/repos/{owner}/{repo}/check-suites/preferences",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "auto_trigger_checks": {
+          "type": "array",
+          "description": "Enables or disables automatic creation of CheckSuite events upon pushes to the repository. Enabled by default."
+        }
+      },
+      "required": [
+        "owner",
+        "repo"
+      ]
+    }
+  },
+  {
+    "name": "checks_get_suite",
+    "description": "Get a check suite",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/check-suites/{check_suite_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_suite_id": {
+          "type": "number",
+          "description": "The unique identifier of the check suite."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_suite_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_list_for_suite",
+    "description": "List check runs in a check suite",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_suite_id": {
+          "type": "number",
+          "description": "The unique identifier of the check suite."
+        },
+        "check_name": {
+          "type": "string",
+          "description": "Returns check runs with the specified `name`."
+        },
+        "status": {
+          "type": "string",
+          "description": "Returns check runs with the specified `status`.",
+          "enum": [
+            "queued",
+            "in_progress",
+            "completed"
+          ]
+        },
+        "filter": {
+          "type": "string",
+          "description": "Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs.",
+          "enum": [
+            "latest",
+            "all"
+          ]
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_suite_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_rerequest_suite",
+    "description": "Rerequest a check suite",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/check-suites/{check_suite_id}/rerequest",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "check_suite_id": {
+          "type": "number",
+          "description": "The unique identifier of the check suite."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "check_suite_id"
+      ]
+    }
+  },
+  {
+    "name": "checks_list_for_ref",
+    "description": "List check runs for a Git reference",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/commits/{ref}/check-runs",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "ref": {
+          "type": "string",
+          "description": "The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        },
+        "check_name": {
+          "type": "string",
+          "description": "Returns check runs with the specified `name`."
+        },
+        "status": {
+          "type": "string",
+          "description": "Returns check runs with the specified `status`.",
+          "enum": [
+            "queued",
+            "in_progress",
+            "completed"
+          ]
+        },
+        "filter": {
+          "type": "string",
+          "description": "Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs.",
+          "enum": [
+            "latest",
+            "all"
+          ]
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "app_id": {
+          "type": "number",
+          "description": "The app_id parameter"
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref"
+      ]
+    }
+  },
+  {
+    "name": "checks_list_suites_for_ref",
+    "description": "List check suites for a Git reference",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/commits/{ref}/check-suites",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "The account owner of the repository. The name is not case sensitive."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The name of the repository without the `.git` extension. The name is not case sensitive."
+        },
+        "ref": {
+          "type": "string",
+          "description": "The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        },
+        "app_id": {
+          "type": "number",
+          "description": "Filters check suites by GitHub App `id`."
+        },
+        "check_name": {
+          "type": "string",
+          "description": "Returns check runs with the specified `name`."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref"
+      ]
+    }
+  }
+];
+
+export const tools = ENDPOINTS.map((e) => ({
+  name: e.name,
+  description: e.description,
+  method: e.method,
+  path: e.path,
+  deleteSendsJsonBody: Boolean(e.deleteSendsJsonBody),
+  inputSchema: e.inputSchema,
+  handler: async (params) => ({
+    content: [{ type: 'text', text: JSON.stringify(await apiRequest(e.method, e.path, params, { deleteSendsJsonBody: e.deleteSendsJsonBody }), null, 2) }],
+  }),
+}));

package/dist/integrations/github-code-scanning/auth.js

@@ -0,0 +1,53 @@
+import { saveCredentials, getCredentials } from '../../core/auth-manager.js';
+import readline from 'readline';
+
+const APP_ID = 'github-code-scanning';
+
+export async function runAuth() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log(`
+┌─────────────────────────────────────────────┐
+│  GitHub Code Scanning Authentication        │
+│                                             │
+│  Use a GitHub Personal Access Token (PAT).  │
+│  Create one in Settings → Developer         │
+│  settings → Personal access tokens.          │
+└─────────────────────────────────────────────┘
+  `);
+
+  const token = await new Promise((resolve) => {
+    rl.question('Paste your GitHub PAT: ', (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+
+  if (!token || token.length < 10) {
+    throw new Error('Invalid token');
+  }
+
+  saveCredentials(APP_ID, {
+    token,
+    tokenType: 'bearer',
+    expiresAt: null,
+    savedAt: new Date().toISOString(),
+  });
+
+  console.log('✅ Token saved for GitHub Code Scanning');
+}
+
+export function getToken() {
+  return getCredentials(APP_ID)?.token || null;
+}
+
+export function buildAuthHeaders() {
+  const token = getToken();
+  if (!token) {
+    throw new Error('Not authenticated. Run: npx adoptai-github-code-scanning-mcp --client cursor');
+  }
+  return { Authorization: 'Bearer ' + token };
+}

package/dist/integrations/github-code-scanning/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { createMCPServer } from '../../core/server-base.js';
+import { tools } from './tools.js';
+
+const { start } = createMCPServer({
+  name: 'github-code-scanning-adoptai',
+  version: '1.0.0',
+  tools,
+});
+
+start();