adoptai-mcp 1.0.0

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

@@ -0,0 +1,633 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-teams';
+
+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": "teams_list",
+    "description": "List teams",
+    "method": "GET",
+    "path": "/orgs/{org}/teams",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "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).\""
+        },
+        "team_type": {
+          "type": "string",
+          "description": "Filter team results by their type. For more information, see \"[What kind of team should I use?](https://docs.github.com/enterprise-cloud@latest/admin/concepts/enterprise-fundamentals/teams-in-an-enterprise#what-kind-of-team-should-i-use)\"",
+          "enum": [
+            "all",
+            "enterprise",
+            "organization"
+          ]
+        }
+      },
+      "required": [
+        "org"
+      ]
+    }
+  },
+  {
+    "name": "teams_create",
+    "description": "Create a team",
+    "method": "POST",
+    "path": "/orgs/{org}/teams",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the team."
+        },
+        "description": {
+          "type": "string",
+          "description": "The description of the team."
+        },
+        "maintainers": {
+          "type": "array",
+          "description": "List GitHub usernames for organization members who will become team maintainers."
+        },
+        "repo_names": {
+          "type": "array",
+          "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to."
+        },
+        "privacy": {
+          "type": "string",
+          "description": "The level of privacy this team should have. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \nDefault: `secret`  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.  \nDefault for child team: `closed`",
+          "enum": [
+            "secret",
+            "closed"
+          ]
+        },
+        "notification_setting": {
+          "type": "string",
+          "description": "The notification setting the team has chosen. The options are:  \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.  \nDefault: `notifications_enabled`",
+          "enum": [
+            "notifications_enabled",
+            "notifications_disabled"
+          ]
+        },
+        "permission": {
+          "type": "string",
+          "description": "**Closing down notice**. The permission that new repositories will be added to the team with when none is specified.",
+          "enum": [
+            "pull",
+            "push"
+          ]
+        },
+        "parent_team_id": {
+          "type": "number",
+          "description": "The ID of a team to set as the parent team."
+        }
+      },
+      "required": [
+        "org",
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "teams_get_by_name",
+    "description": "Get a team by name",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_update_in_org",
+    "description": "Update a team",
+    "method": "PATCH",
+    "path": "/orgs/{org}/teams/{team_slug}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the team."
+        },
+        "description": {
+          "type": "string",
+          "description": "The description of the team."
+        },
+        "privacy": {
+          "type": "string",
+          "description": "The level of privacy this team should have. Editing teams without specifying this parameter leaves `privacy` intact. When a team is nested, the `privacy` for parent teams cannot be `secret`. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.",
+          "enum": [
+            "secret",
+            "closed"
+          ]
+        },
+        "notification_setting": {
+          "type": "string",
+          "description": "The notification setting the team has chosen. Editing teams without specifying this parameter leaves `notification_setting` intact. The options are: \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.",
+          "enum": [
+            "notifications_enabled",
+            "notifications_disabled"
+          ]
+        },
+        "permission": {
+          "type": "string",
+          "description": "**Closing down notice**. The permission that new repositories will be added to the team with when none is specified.",
+          "enum": [
+            "pull",
+            "push",
+            "admin"
+          ]
+        },
+        "parent_team_id": {
+          "type": "number",
+          "description": "The ID of a team to set as the parent team."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_delete_in_org",
+    "description": "Delete a team",
+    "method": "DELETE",
+    "path": "/orgs/{org}/teams/{team_slug}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_list_pending_invitations_in_org",
+    "description": "List pending team invitations",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/invitations",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team 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": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_list_members_in_org",
+    "description": "List team members",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/members",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "role": {
+          "type": "string",
+          "description": "Filters members returned by their role in the team.",
+          "enum": [
+            "member",
+            "maintainer",
+            "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": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_get_membership_for_user_in_org",
+    "description": "Get team membership for a user",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/memberships/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "teams_add_or_update_membership_for_user_in_org",
+    "description": "Add or update team membership for a user",
+    "method": "PUT",
+    "path": "/orgs/{org}/teams/{team_slug}/memberships/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "role": {
+          "type": "string",
+          "description": "The role that this user should have in the team.",
+          "enum": [
+            "member",
+            "maintainer"
+          ]
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "teams_remove_membership_for_user_in_org",
+    "description": "Remove team membership for a user",
+    "method": "DELETE",
+    "path": "/orgs/{org}/teams/{team_slug}/memberships/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "teams_list_repos_in_org",
+    "description": "List team repositories",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/repos",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team 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": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_check_permissions_for_repo_in_org",
+    "description": "Check team permissions for a repository",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "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."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "owner",
+        "repo"
+      ]
+    }
+  },
+  {
+    "name": "teams_add_or_update_repo_permissions_in_org",
+    "description": "Add or update team repository permissions",
+    "method": "PUT",
+    "path": "/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "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."
+        },
+        "permission": {
+          "type": "string",
+          "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "owner",
+        "repo"
+      ]
+    }
+  },
+  {
+    "name": "teams_remove_repo_in_org",
+    "description": "Remove a repository from a team",
+    "method": "DELETE",
+    "path": "/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team name."
+        },
+        "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."
+        }
+      },
+      "required": [
+        "org",
+        "team_slug",
+        "owner",
+        "repo"
+      ]
+    }
+  },
+  {
+    "name": "teams_list_child_in_org",
+    "description": "List child teams",
+    "method": "GET",
+    "path": "/orgs/{org}/teams/{team_slug}/teams",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "team_slug": {
+          "type": "string",
+          "description": "The slug of the team 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": [
+        "org",
+        "team_slug"
+      ]
+    }
+  },
+  {
+    "name": "teams_list_for_authenticated_user",
+    "description": "List teams for the authenticated user",
+    "method": "GET",
+    "path": "/user/teams",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "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": []
+    }
+  }
+];
+
+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-users/auth.js

@@ -0,0 +1,53 @@
+import { saveCredentials, getCredentials } from '../../core/auth-manager.js';
+import readline from 'readline';
+
+const APP_ID = 'github-users';
+
+export async function runAuth() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log(`
+┌─────────────────────────────────────────────┐
+│  GitHub Users 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 Users');
+}
+
+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-users-mcp --client cursor');
+  }
+  return { Authorization: 'Bearer ' + token };
+}