adoptai-mcp 1.0.0

package/dist/integrations/github-git/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-git-adoptai' });
+  console.log(`✅ GitHub Git MCP removed from ${clientFlag}`);
+  process.exit(0);
+}
+
+if (isStatus) {
+  const creds = getCredentials('github-git');
+  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-git');
+
+  if (existing && !isTokenExpired('github-git')) {
+    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-git-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-git-adoptai',
+    command: 'node',
+    args: [indexPath],
+    env: {},
+  });
+
+  console.log(`
+✅ GitHub Git MCP is ready!
+────────────────────────────────────────
+Your AI (${clientFlag}) can now use 13 tools.
+
+Try asking:
+  "Create a git blob in owner/repo"
+  "Get a git commit by SHA in owner/repo"
+
+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-git/tools.js

@@ -0,0 +1,513 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-git';
+
+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": "git_create_blob",
+    "description": "Create a blob",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/git/blobs",
+    "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."
+        },
+        "content": {
+          "type": "string",
+          "description": "The new blob's content."
+        },
+        "encoding": {
+          "type": "string",
+          "description": "The encoding used for `content`. Currently, `\"utf-8\"` and `\"base64\"` are supported."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "content"
+      ]
+    }
+  },
+  {
+    "name": "git_get_blob",
+    "description": "Get a blob",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/blobs/{file_sha}",
+    "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."
+        },
+        "file_sha": {
+          "type": "string",
+          "description": "The file_sha parameter"
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "file_sha"
+      ]
+    }
+  },
+  {
+    "name": "git_create_commit",
+    "description": "Create a commit",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/git/commits",
+    "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."
+        },
+        "message": {
+          "type": "string",
+          "description": "The commit message"
+        },
+        "tree": {
+          "type": "string",
+          "description": "The SHA of the tree object this commit points to"
+        },
+        "parents": {
+          "type": "array",
+          "description": "The full SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided; for a merge commit, an array of more than one should be provided."
+        },
+        "author": {
+          "type": "object",
+          "description": "Information about the author of the commit. By default, the `author` will be the authenticated user and the current date. See the `author` and `committer` object below for details."
+        },
+        "committer": {
+          "type": "object",
+          "description": "Information about the person who is making the commit. By default, `committer` will use the information set in `author`. See the `author` and `committer` object below for details."
+        },
+        "signature": {
+          "type": "string",
+          "description": "The [PGP signature](https://en.wikipedia.org/wiki/Pretty_Good_Privacy) of the commit. GitHub adds the signature to the `gpgsig` header of the created commit. For a commit signature to be verifiable by Git or GitHub, it must be an ASCII-armored detached PGP signature over the string commit as it would be written to the object database. To pass a `signature` parameter, you need to first manually create a valid PGP signature, which can be complicated. You may find it easier to [use the command line](https://git-scm.com/book/id/v2/Git-Tools-Signing-Your-Work) to create signed commits."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "message",
+        "tree"
+      ]
+    }
+  },
+  {
+    "name": "git_get_commit",
+    "description": "Get a commit object",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/commits/{commit_sha}",
+    "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."
+        },
+        "commit_sha": {
+          "type": "string",
+          "description": "The SHA of the commit."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "commit_sha"
+      ]
+    }
+  },
+  {
+    "name": "git_list_matching_refs",
+    "description": "List matching references",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/matching-refs/{ref}",
+    "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 Git reference. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref"
+      ]
+    }
+  },
+  {
+    "name": "git_get_ref",
+    "description": "Get a reference",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/ref/{ref}",
+    "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 Git reference. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref"
+      ]
+    }
+  },
+  {
+    "name": "git_create_ref",
+    "description": "Create a reference",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/git/refs",
+    "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 name of the fully qualified reference (ie: `refs/heads/master`). If it doesn't start with 'refs' and have at least two slashes, it will be rejected."
+        },
+        "sha": {
+          "type": "string",
+          "description": "The SHA1 value for this reference."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref",
+        "sha"
+      ]
+    }
+  },
+  {
+    "name": "git_update_ref",
+    "description": "Update a reference",
+    "method": "PATCH",
+    "path": "/repos/{owner}/{repo}/git/refs/{ref}",
+    "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 Git reference. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        },
+        "sha": {
+          "type": "string",
+          "description": "The SHA1 value to set this reference to"
+        },
+        "force": {
+          "type": "boolean",
+          "description": "Indicates whether to force the update or to make sure the update is a fast-forward update. Leaving this out or setting it to `false` will make sure you're not overwriting work."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref",
+        "sha"
+      ]
+    }
+  },
+  {
+    "name": "git_delete_ref",
+    "description": "Delete a reference",
+    "method": "DELETE",
+    "path": "/repos/{owner}/{repo}/git/refs/{ref}",
+    "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 Git reference. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "ref"
+      ]
+    }
+  },
+  {
+    "name": "git_create_tag",
+    "description": "Create a tag object",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/git/tags",
+    "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."
+        },
+        "tag": {
+          "type": "string",
+          "description": "The tag's name. This is typically a version (e.g., \"v0.0.1\")."
+        },
+        "message": {
+          "type": "string",
+          "description": "The tag message."
+        },
+        "object": {
+          "type": "string",
+          "description": "The SHA of the git object this is tagging."
+        },
+        "type": {
+          "type": "string",
+          "description": "The type of the object we're tagging. Normally this is a `commit` but it can also be a `tree` or a `blob`.",
+          "enum": [
+            "commit",
+            "tree",
+            "blob"
+          ]
+        },
+        "tagger": {
+          "type": "object",
+          "description": "An object with information about the individual creating the tag."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "tag",
+        "message",
+        "object",
+        "type"
+      ]
+    }
+  },
+  {
+    "name": "git_get_tag",
+    "description": "Get a tag",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/tags/{tag_sha}",
+    "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."
+        },
+        "tag_sha": {
+          "type": "string",
+          "description": "The tag_sha parameter"
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "tag_sha"
+      ]
+    }
+  },
+  {
+    "name": "git_create_tree",
+    "description": "Create a tree",
+    "method": "POST",
+    "path": "/repos/{owner}/{repo}/git/trees",
+    "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."
+        },
+        "tree": {
+          "type": "array",
+          "description": "Objects (of `path`, `mode`, `type`, and `sha`) specifying a tree structure."
+        },
+        "base_tree": {
+          "type": "string",
+          "description": "The SHA1 of an existing Git tree object which will be used as the base for the new tree. If provided, a new Git tree object will be created from entries in the Git tree object pointed to by `base_tree` and entries defined in the `tree` parameter. Entries defined in the `tree` parameter will overwrite items from `base_tree` with the same `path`. If you're creating new changes on a branch, then normally you'd set `base_tree` to the SHA1 of the Git tree object of the current latest commit on the branch you're working on.\nIf not provided, GitHub will create a new Git tree object from only the entries defined in the `tree` parameter. If you create a new commit pointing to such a tree, then all files which were a part of the parent commit's tree and were not defined in the `tree` parameter will be listed as deleted by the new commit."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "tree"
+      ]
+    }
+  },
+  {
+    "name": "git_get_tree",
+    "description": "Get a tree",
+    "method": "GET",
+    "path": "/repos/{owner}/{repo}/git/trees/{tree_sha}",
+    "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."
+        },
+        "tree_sha": {
+          "type": "string",
+          "description": "The SHA1 value or ref (branch or tag) name of the tree."
+        },
+        "recursive": {
+          "type": "string",
+          "description": "Setting this parameter to any value returns the objects or subtrees referenced by the tree specified in `:tree_sha`. For example, setting `recursive` to any of the following will enable returning objects or subtrees: `0`, `1`, `\"true\"`, and `\"false\"`. Omit this parameter to prevent recursively returning objects or subtrees."
+        }
+      },
+      "required": [
+        "owner",
+        "repo",
+        "tree_sha"
+      ]
+    }
+  }
+];
+
+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-issues/auth.js

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

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