adoptai-mcp 1.0.0

package/dist/integrations/github-search/auth.js

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

package/dist/integrations/github-search/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-search-adoptai',
+  version: '1.0.0',
+  tools,
+});
+
+start();

package/dist/integrations/github-search/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "adoptai-github-search-mcp",
+  "version": "1.0.0",
+  "description": "GitHub's v3 REST API — search across code, repos, issues, commits, users, and related endpoints (OpenAPI-derived).",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "adoptai-github-search-mcp": "./setup.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "setup": "node setup.js"
+  },
+  "keywords": ["mcp", "github", "github-search", "search", "ai", "cursor", "claude", "adopt.ai"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0"
+  },
+  "adoptai": {
+    "appId": "github-search",
+    "toolCount": 7,
+    "sourceFormat": "openapi_3.1",
+    "authType": "bearer",
+    "generatedAt": "2026-03-26T12:00:00.000Z"
+  }
+}

package/dist/integrations/github-search/setup.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { writeConfig, removeConfig } from '../../core/config-writer.js';
+import { getCredentials, isTokenExpired } from '../../core/auth-manager.js';
+import { runAuth } from './auth.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import readline from 'readline';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+
+const clientFlag = args.includes('--client')
+  ? args[args.indexOf('--client') + 1]
+  : 'cursor';
+
+const isRemove = args.includes('--remove');
+const isStatus = args.includes('--status');
+
+const SUPPORTED_CLIENTS = ['cursor', 'claude', 'windsurf', 'vscode'];
+
+if (isRemove) {
+  removeConfig({ client: clientFlag, serverName: 'github-search-adoptai' });
+  console.log(`✅ GitHub Search MCP removed from ${clientFlag}`);
+  process.exit(0);
+}
+
+if (isStatus) {
+  const creds = getCredentials('github-search');
+  if (!creds) {
+    console.log('❌ Not authenticated');
+  } else {
+    console.log('✅ Authenticated');
+    console.log(`   Token: ${creds.token?.substring(0, 12)}...`);
+    console.log(`   Saved: ${creds.savedAt}`);
+  }
+  process.exit(0);
+}
+
+if (!SUPPORTED_CLIENTS.includes(clientFlag)) {
+  console.error(`Invalid client: ${clientFlag}`);
+  console.error(`Supported: ${SUPPORTED_CLIENTS.join(', ')}`);
+  process.exit(1);
+}
+
+async function main() {
+  const existing = getCredentials('github-search');
+
+  if (existing && !isTokenExpired('github-search')) {
+    console.log('✅ Already authenticated');
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    const answer = await new Promise((resolveAns) => {
+      rl.question('Re-authenticate? (y/n): ', (a) => {
+        rl.close();
+        resolveAns(a.trim().toLowerCase());
+      });
+    });
+
+    if (answer !== 'y') {
+      writeConfig({
+        client: clientFlag,
+        serverName: 'github-search-adoptai',
+        command: 'node',
+        args: [resolve(__dirname, 'index.js')],
+        env: {},
+      });
+      process.exit(0);
+    }
+  }
+
+  await runAuth();
+
+  const indexPath = resolve(__dirname, 'index.js');
+
+  writeConfig({
+    client: clientFlag,
+    serverName: 'github-search-adoptai',
+    command: 'node',
+    args: [indexPath],
+    env: {},
+  });
+
+  console.log(`
+✅ GitHub Search MCP is ready!
+────────────────────────────────────────
+Your AI (${clientFlag}) can now use 7 tools.
+
+Try asking:
+  "Search repositories"
+  "Search code"
+
+Run health check: node core/doctor.js --client ${clientFlag}
+  `);
+}
+
+main().catch((err) => {
+  console.error('❌ Setup failed:', err.message);
+  process.exit(1);
+});

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

@@ -0,0 +1,370 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-search';
+
+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": "search_code",
+    "description": "Search code",
+    "method": "GET",
+    "path": "/search/code",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query). See \"[Searching code](https://docs.github.com/search-github/searching-on-github/searching-code)\" for a detailed list of qualifiers."
+        },
+        "sort": {
+          "type": "string",
+          "description": "**This field is closing down.** Sorts the results of your query. Can only be `indexed`, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "indexed"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "**This field is closing down.** Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. ",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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": [
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_commits",
+    "description": "Search commits",
+    "method": "GET",
+    "path": "/search/commits",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query). See \"[Searching commits](https://docs.github.com/search-github/searching-on-github/searching-commits)\" for a detailed list of qualifiers."
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sorts the results of your query by `author-date` or `committer-date`. Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "author-date",
+            "committer-date"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`.",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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": [
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_issues_and_pull_requests",
+    "description": "Search issues and pull requests",
+    "method": "GET",
+    "path": "/search/issues",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query). See \"[Searching issues and pull requests](https://docs.github.com/search-github/searching-on-github/searching-issues-and-pull-requests)\" for a detailed list of qualifiers."
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sorts the results of your query by the number of `comments`, `reactions`, `reactions-+1`, `reactions--1`, `reactions-smile`, `reactions-thinking_face`, `reactions-heart`, `reactions-tada`, or `interactions`. You can also sort results by how recently the items were `created` or `updated`, Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "comments",
+            "reactions",
+            "reactions-+1",
+            "reactions--1",
+            "reactions-smile",
+            "reactions-thinking_face",
+            "reactions-heart",
+            "reactions-tada",
+            "interactions",
+            "created",
+            "updated"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`.",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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).\""
+        },
+        "advanced_search": {
+          "type": "string",
+          "description": "Set to `true` to use advanced search.\nExample: `http://api.github.com/search/issues?q={query}&advanced_search=true`"
+        }
+      },
+      "required": [
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_labels",
+    "description": "Search labels",
+    "method": "GET",
+    "path": "/search/labels",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "repository_id": {
+          "type": "number",
+          "description": "The id of the repository."
+        },
+        "q": {
+          "type": "string",
+          "description": "The search keywords. This endpoint does not accept qualifiers in the query. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query)."
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sorts the results of your query by when the label was `created` or `updated`. Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "created",
+            "updated"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`.",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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": [
+        "repository_id",
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_repos",
+    "description": "Search repositories",
+    "method": "GET",
+    "path": "/search/repositories",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query). See \"[Searching for repositories](https://docs.github.com/articles/searching-for-repositories/)\" for a detailed list of qualifiers."
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sorts the results of your query by number of `stars`, `forks`, or `help-wanted-issues` or how recently the items were `updated`. Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "stars",
+            "forks",
+            "help-wanted-issues",
+            "updated"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`.",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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": [
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_topics",
+    "description": "Search topics",
+    "method": "GET",
+    "path": "/search/topics",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query)."
+        },
+        "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": [
+        "q"
+      ]
+    }
+  },
+  {
+    "name": "search_users",
+    "description": "Search users",
+    "method": "GET",
+    "path": "/search/users",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": {
+          "type": "string",
+          "description": "The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see [Constructing a search query](https://docs.github.com/rest/search/search#constructing-a-search-query). See \"[Searching users](https://docs.github.com/search-github/searching-on-github/searching-users)\" for a detailed list of qualifiers."
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sorts the results of your query by number of `followers` or `repositories`, or when the person `joined` GitHub. Default: [best match](https://docs.github.com/rest/search/search#ranking-search-results)",
+          "enum": [
+            "followers",
+            "repositories",
+            "joined"
+          ]
+        },
+        "order": {
+          "type": "string",
+          "description": "Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`.",
+          "enum": [
+            "desc",
+            "asc"
+          ]
+        },
+        "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": [
+        "q"
+      ]
+    }
+  }
+];
+
+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-teams/auth.js

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

package/dist/integrations/github-teams/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-teams-adoptai',
+  version: '1.0.0',
+  tools,
+});
+
+start();

package/dist/integrations/github-teams/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "adoptai-github-teams-mcp",
+  "version": "1.0.0",
+  "description": "GitHub's v3 REST API — teams, memberships, repos, discussions, and related endpoints (OpenAPI-derived).",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "adoptai-github-teams-mcp": "./setup.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "setup": "node setup.js"
+  },
+  "keywords": ["mcp", "github", "github-teams", "teams", "ai", "cursor", "claude", "adopt.ai"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0"
+  },
+  "adoptai": {
+    "appId": "github-teams",
+    "toolCount": 16,
+    "sourceFormat": "openapi_3.1",
+    "authType": "bearer",
+    "generatedAt": "2026-03-26T12:00:00.000Z"
+  }
+}