adoptai-mcp 1.0.0

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

@@ -0,0 +1,545 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-gists';
+
+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": "gists_list",
+    "description": "List gists for the authenticated user",
+    "method": "GET",
+    "path": "/gists",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "since": {
+          "type": "string",
+          "description": "Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "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": []
+    }
+  },
+  {
+    "name": "gists_create",
+    "description": "Create a gist",
+    "method": "POST",
+    "path": "/gists",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of the gist"
+        },
+        "files": {
+          "type": "object",
+          "description": "Names and content for the files that make up the gist"
+        },
+        "public": {
+          "type": "string",
+          "description": "The public field"
+        }
+      },
+      "required": [
+        "files"
+      ]
+    }
+  },
+  {
+    "name": "gists_list_public",
+    "description": "List public gists",
+    "method": "GET",
+    "path": "/gists/public",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "since": {
+          "type": "string",
+          "description": "Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "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": []
+    }
+  },
+  {
+    "name": "gists_list_starred",
+    "description": "List starred gists",
+    "method": "GET",
+    "path": "/gists/starred",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "since": {
+          "type": "string",
+          "description": "Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "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": []
+    }
+  },
+  {
+    "name": "gists_get",
+    "description": "Get a gist",
+    "method": "GET",
+    "path": "/gists/{gist_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_update",
+    "description": "Update a gist",
+    "method": "PATCH",
+    "path": "/gists/{gist_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "description": {
+          "type": "string",
+          "description": "The description of the gist."
+        },
+        "files": {
+          "type": "object",
+          "description": "The gist files to be updated, renamed, or deleted. Each `key` must match the current filename\n(including extension) of the targeted gist file. For example: `hello.py`.\n\nTo delete a file, set the whole file to null. For example: `hello.py : null`. The file will also be\ndeleted if the specified object does not contain at least one of `content` or `filename`."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_delete",
+    "description": "Delete a gist",
+    "method": "DELETE",
+    "path": "/gists/{gist_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_list_comments",
+    "description": "List gist comments",
+    "method": "GET",
+    "path": "/gists/{gist_id}/comments",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "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": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_create_comment",
+    "description": "Create a gist comment",
+    "method": "POST",
+    "path": "/gists/{gist_id}/comments",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "body": {
+          "type": "string",
+          "description": "The comment text."
+        }
+      },
+      "required": [
+        "gist_id",
+        "body"
+      ]
+    }
+  },
+  {
+    "name": "gists_get_comment",
+    "description": "Get a gist comment",
+    "method": "GET",
+    "path": "/gists/{gist_id}/comments/{comment_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "comment_id": {
+          "type": "number",
+          "description": "The unique identifier of the comment."
+        }
+      },
+      "required": [
+        "gist_id",
+        "comment_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_update_comment",
+    "description": "Update a gist comment",
+    "method": "PATCH",
+    "path": "/gists/{gist_id}/comments/{comment_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "comment_id": {
+          "type": "number",
+          "description": "The unique identifier of the comment."
+        },
+        "body": {
+          "type": "string",
+          "description": "The comment text."
+        }
+      },
+      "required": [
+        "gist_id",
+        "comment_id",
+        "body"
+      ]
+    }
+  },
+  {
+    "name": "gists_delete_comment",
+    "description": "Delete a gist comment",
+    "method": "DELETE",
+    "path": "/gists/{gist_id}/comments/{comment_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "comment_id": {
+          "type": "number",
+          "description": "The unique identifier of the comment."
+        }
+      },
+      "required": [
+        "gist_id",
+        "comment_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_list_commits",
+    "description": "List gist commits",
+    "method": "GET",
+    "path": "/gists/{gist_id}/commits",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "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": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_list_forks",
+    "description": "List gist forks",
+    "method": "GET",
+    "path": "/gists/{gist_id}/forks",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "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": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_fork",
+    "description": "Fork a gist",
+    "method": "POST",
+    "path": "/gists/{gist_id}/forks",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_check_is_starred",
+    "description": "Check if a gist is starred",
+    "method": "GET",
+    "path": "/gists/{gist_id}/star",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_star",
+    "description": "Star a gist",
+    "method": "PUT",
+    "path": "/gists/{gist_id}/star",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_unstar",
+    "description": "Unstar a gist",
+    "method": "DELETE",
+    "path": "/gists/{gist_id}/star",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        }
+      },
+      "required": [
+        "gist_id"
+      ]
+    }
+  },
+  {
+    "name": "gists_get_revision",
+    "description": "Get a gist revision",
+    "method": "GET",
+    "path": "/gists/{gist_id}/{sha}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gist_id": {
+          "type": "string",
+          "description": "The unique identifier of the gist."
+        },
+        "sha": {
+          "type": "string",
+          "description": "The sha parameter"
+        }
+      },
+      "required": [
+        "gist_id",
+        "sha"
+      ]
+    }
+  },
+  {
+    "name": "gists_list_for_user",
+    "description": "List gists for a user",
+    "method": "GET",
+    "path": "/users/{username}/gists",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "since": {
+          "type": "string",
+          "description": "Only show results that were last updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`."
+        },
+        "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": [
+        "username"
+      ]
+    }
+  }
+];
+
+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-git/auth.js

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

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

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

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