@abhishekmcp/github 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @abhishekmcp/github
+
+A GitHub [MCP](https://modelcontextprotocol.io) server: search, browse, and act on GitHub from any MCP
+client. Authenticates via **OAuth device flow** (real OAuth, no hosted callback) or a **token**. Pure
+JavaScript ([`@octokit/rest`](https://github.com/octokit/rest.js)), no native dependencies.
+
+> GitHub ships an official, much larger MCP server. This is a focused, learning-oriented build that does
+> auth/secrets handling cleanly.
+
+## Tools
+
+**Auth:** `github_login` (device flow), `github_logout`, `whoami`
+**Search:** `search_repos`, `search_code`, `search_issues`
+**Read:** `get_repo`, `list_issues`, `get_issue`, `list_pull_requests`, `get_pull_request`,
+`get_file_contents`, `list_notifications`, `rate_limit`
+**Write** (omitted when `GITHUB_READONLY=1`): `create_issue`, `add_issue_comment`
+
+Responses are trimmed to the useful fields to stay token-efficient.
+
+## Authentication
+
+Resolved in this order (nothing is required at startup):
+
+1. **Token** — `GITHUB_TOKEN` (or `GITHUB_PERSONAL_ACCESS_TOKEN`). A [Personal Access Token](https://github.com/settings/tokens); simplest path.
+2. **Cached OAuth token** — from a previous `github_login`, stored at `~/.config/mcp-github/auth.json` (`0600`), auto-refreshed when possible.
+3. Otherwise tools return a clear "run `github_login`" message.
+
+### OAuth device flow (one-time setup)
+Device flow needs a **public** OAuth-App client id (no secret):
+1. Create a [GitHub OAuth App](https://github.com/settings/developers) and **enable Device Flow**.
+2. `export GITHUB_CLIENT_ID=<client id>`.
+3. Run `github_login` → open the printed URL, enter the code, then run `github_login` again to finish.
+
+Tokens are cached locally with `0600` permissions and are never logged.
+
+## Configuration
+
+| Variable | Effect |
+|----------|--------|
+| `GITHUB_TOKEN` / `GITHUB_PERSONAL_ACCESS_TOKEN` | Use this PAT (skips OAuth). |
+| `GITHUB_CLIENT_ID` | OAuth App client id for the device-flow login. |
+| `GITHUB_READONLY` | `1`/`true` → only read + auth tools are registered. |
+
+## Usage
+
+```bash
+# Claude Code (plugin):  /plugin marketplace add Abhishekkumar2021/mcp-suite  →  /plugin install github
+# Claude Code (manual):
+claude mcp add github --env GITHUB_TOKEN=<pat> -- npx -y @abhishekmcp/github
+```
+
+```json
+{
+  "mcpServers": {
+    "github": { "command": "npx", "args": ["-y", "@abhishekmcp/github"], "env": { "GITHUB_TOKEN": "<pat>" } }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,21 @@
+export declare class NotAuthenticatedError extends Error {
+    constructor(msg?: string);
+}
+/**
+ * Resolve a usable token. Order: env PAT → cached (refresh if expired) →
+ * throw NotAuthenticatedError.
+ */
+export declare function getToken(): Promise<string>;
+/** How the current token was obtained (for status messaging). */
+export declare function authSource(): Promise<"env" | "cache" | "none">;
+export interface LoginStatus {
+    state: "instructions" | "authorized" | "pending" | "error";
+    message: string;
+}
+/**
+ * Drive the device flow. First call requests a code and returns instructions;
+ * subsequent calls poll the same code (resilient to MCP tool-call timeouts).
+ */
+export declare function login(maxPollMs?: number): Promise<LoginStatus>;
+/** Clear any cached token + pending device code. */
+export declare function logout(): Promise<void>;

package/dist/auth.js

@@ -0,0 +1,158 @@
+/**
+ * Authentication: resolves a usable GitHub token from (1) an env PAT, (2) a
+ * cached OAuth token (refreshed if expired), or (3) the OAuth **device flow**.
+ * The device flow is hand-rolled against GitHub's 3 endpoints; tokens are cached
+ * at ~/.config/mcp-github/auth.json with 0600 perms and are never logged.
+ */
+import { promises as fs } from "node:fs";
+import { ACCESS_TOKEN_URL, DEVICE_CODE_URL, SCOPES, getAuthFile, getClientId, getConfigDir, getEnvToken, } from "./config.js";
+export class NotAuthenticatedError extends Error {
+    constructor(msg = "Not authenticated. Run github_login, or set GITHUB_TOKEN to a Personal Access Token.") {
+        super(msg);
+        this.name = "NotAuthenticatedError";
+    }
+}
+async function loadCache() {
+    try {
+        return JSON.parse(await fs.readFile(getAuthFile(), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+async function saveCache(cache) {
+    await fs.mkdir(getConfigDir(), { recursive: true });
+    const file = getAuthFile();
+    const tmp = `${file}.${process.pid}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(cache, null, 2), { mode: 0o600 });
+    await fs.rename(tmp, file);
+    await fs.chmod(file, 0o600).catch(() => { });
+}
+/** POST application/x-www-form-urlencoded, parse JSON. */
+async function postForm(url, params) {
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
+        body: new URLSearchParams(params).toString(),
+    });
+    return res.json();
+}
+/** Exchange a refresh token for a fresh access token (if the app issues them). */
+async function refresh(stored) {
+    const clientId = getClientId();
+    if (!clientId || !stored.refresh_token)
+        return undefined;
+    const data = await postForm(ACCESS_TOKEN_URL, {
+        client_id: clientId,
+        grant_type: "refresh_token",
+        refresh_token: stored.refresh_token,
+    });
+    if (!data.access_token)
+        return undefined;
+    return tokenFromResponse(data);
+}
+function tokenFromResponse(data) {
+    return {
+        access_token: data.access_token,
+        refresh_token: data.refresh_token,
+        expires_at: data.expires_in ? Date.now() + Number(data.expires_in) * 1000 : undefined,
+        scope: data.scope,
+    };
+}
+/**
+ * Resolve a usable token. Order: env PAT → cached (refresh if expired) →
+ * throw NotAuthenticatedError.
+ */
+export async function getToken() {
+    const env = getEnvToken();
+    if (env)
+        return env;
+    const cache = await loadCache();
+    const stored = cache.token;
+    if (stored) {
+        const expired = stored.expires_at !== undefined && Date.now() >= stored.expires_at - 30_000;
+        if (!expired)
+            return stored.access_token;
+        const refreshed = await refresh(stored);
+        if (refreshed) {
+            await saveCache({ ...cache, token: refreshed });
+            return refreshed.access_token;
+        }
+        // expired and not refreshable → fall through to unauthenticated
+    }
+    throw new NotAuthenticatedError();
+}
+/** How the current token was obtained (for status messaging). */
+export async function authSource() {
+    if (getEnvToken())
+        return "env";
+    return (await loadCache()).token ? "cache" : "none";
+}
+/**
+ * Drive the device flow. First call requests a code and returns instructions;
+ * subsequent calls poll the same code (resilient to MCP tool-call timeouts).
+ */
+export async function login(maxPollMs = 50_000) {
+    const clientId = getClientId();
+    if (!clientId) {
+        return {
+            state: "error",
+            message: "Device login needs a GitHub OAuth App. Set GITHUB_CLIENT_ID (register an OAuth App with device flow enabled), or use a Personal Access Token via GITHUB_TOKEN.",
+        };
+    }
+    const cache = await loadCache();
+    let pending = cache.pending;
+    // No live pending code → request one and return instructions.
+    if (!pending || Date.now() >= pending.expires_at) {
+        const data = await postForm(DEVICE_CODE_URL, { client_id: clientId, scope: SCOPES });
+        if (!data.device_code) {
+            return { state: "error", message: `Failed to start device flow: ${data.error_description || data.error || "unknown error"}` };
+        }
+        pending = {
+            device_code: data.device_code,
+            user_code: data.user_code,
+            verification_uri: data.verification_uri,
+            interval: Number(data.interval) || 5,
+            expires_at: Date.now() + Number(data.expires_in || 900) * 1000,
+        };
+        await saveCache({ ...cache, pending });
+        return {
+            state: "instructions",
+            message: `Open ${pending.verification_uri} and enter code ${pending.user_code}, then run github_login again to finish.`,
+        };
+    }
+    // Live pending code → poll for authorization (bounded).
+    const deadline = Date.now() + maxPollMs;
+    let interval = pending.interval;
+    while (Date.now() < deadline) {
+        const data = await postForm(ACCESS_TOKEN_URL, {
+            client_id: clientId,
+            device_code: pending.device_code,
+            grant_type: "urn:ietf:params:oauth:grant-type:device_code",
+        });
+        if (data.access_token) {
+            await saveCache({ token: tokenFromResponse(data) }); // clears pending
+            return { state: "authorized", message: "Authenticated with GitHub. ✅" };
+        }
+        if (data.error === "authorization_pending") {
+            // keep waiting
+        }
+        else if (data.error === "slow_down") {
+            interval = (Number(data.interval) || interval) + 5;
+        }
+        else {
+            await saveCache({ ...cache, pending: undefined });
+            return { state: "error", message: `Device login failed: ${data.error_description || data.error}` };
+        }
+        await new Promise((r) => setTimeout(r, interval * 1000));
+    }
+    return {
+        state: "pending",
+        message: `Still waiting for authorization. Open ${pending.verification_uri} (code ${pending.user_code}) and run github_login again.`,
+    };
+}
+/** Clear any cached token + pending device code. */
+export async function logout() {
+    await fs.rm(getAuthFile(), { force: true });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+/** Server version (kept in lockstep with package.json + index.ts). */
+export declare const VERSION = "0.1.0";
+/** OAuth scopes requested by the device flow (space-separated). */
+export declare const SCOPES = "repo read:org notifications";
+/** Default page size for list/search endpoints. */
+export declare const DEFAULT_PER_PAGE = 30;
+/** GitHub OAuth endpoints (device flow). */
+export declare const DEVICE_CODE_URL = "https://github.com/login/device/code";
+export declare const ACCESS_TOKEN_URL = "https://github.com/login/oauth/access_token";
+/**
+ * Public OAuth-App client id for the device flow (no client secret needed).
+ * Register a GitHub OAuth App with device flow enabled and set GITHUB_CLIENT_ID.
+ * The PAT path works without this.
+ */
+export declare function getClientId(): string | undefined;
+/** A Personal Access Token from the environment, if provided. */
+export declare function getEnvToken(): string | undefined;
+/** Config directory for the cached token (XDG-aware). */
+export declare function getConfigDir(): string;
+/** Path to the 0600 token cache. */
+export declare function getAuthFile(): string;
+/** When true, write tools are not registered. */
+export declare function isReadOnly(): boolean;

package/dist/config.js

@@ -0,0 +1,38 @@
+import { homedir } from "node:os";
+import path from "node:path";
+/** Server version (kept in lockstep with package.json + index.ts). */
+export const VERSION = "0.1.0";
+/** OAuth scopes requested by the device flow (space-separated). */
+export const SCOPES = "repo read:org notifications";
+/** Default page size for list/search endpoints. */
+export const DEFAULT_PER_PAGE = 30;
+/** GitHub OAuth endpoints (device flow). */
+export const DEVICE_CODE_URL = "https://github.com/login/device/code";
+export const ACCESS_TOKEN_URL = "https://github.com/login/oauth/access_token";
+/**
+ * Public OAuth-App client id for the device flow (no client secret needed).
+ * Register a GitHub OAuth App with device flow enabled and set GITHUB_CLIENT_ID.
+ * The PAT path works without this.
+ */
+export function getClientId() {
+    return process.env.GITHUB_CLIENT_ID?.trim() || undefined;
+}
+/** A Personal Access Token from the environment, if provided. */
+export function getEnvToken() {
+    return (process.env.GITHUB_TOKEN || process.env.GITHUB_PERSONAL_ACCESS_TOKEN)?.trim() || undefined;
+}
+/** Config directory for the cached token (XDG-aware). */
+export function getConfigDir() {
+    const base = process.env.XDG_CONFIG_HOME?.trim() || path.join(homedir(), ".config");
+    return path.join(base, "mcp-github");
+}
+/** Path to the 0600 token cache. */
+export function getAuthFile() {
+    return path.join(getConfigDir(), "auth.json");
+}
+/** When true, write tools are not registered. */
+export function isReadOnly() {
+    const v = (process.env.GITHUB_READONLY ?? "").toLowerCase();
+    return v === "1" || v === "true";
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,6BAA6B,CAAC;AAEpD,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AAE9E;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAC3D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACrG,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC;AACnC,CAAC"}

package/dist/gh.d.ts

@@ -0,0 +1,130 @@
+export declare function whoami(): Promise<{
+    login: string;
+    name: string | null;
+    url: string;
+    public_repos: number;
+    private_repos: number | undefined;
+}>;
+export declare function searchRepos(q: string, limit?: number): Promise<{
+    full_name: string;
+    stars: number;
+    language: string | null;
+    description: string | null;
+    url: string;
+}[]>;
+export declare function searchCode(q: string, limit?: number): Promise<{
+    repo: string;
+    path: string;
+    url: string;
+}[]>;
+export declare function searchIssues(q: string, limit?: number): Promise<{
+    repo: string;
+    number: number;
+    title: string;
+    state: string;
+    is_pr: boolean;
+    url: string;
+}[]>;
+export declare function getRepo(owner: string, repo: string): Promise<{
+    full_name: string;
+    description: string | null;
+    stars: number;
+    forks: number;
+    open_issues: number;
+    language: string | null;
+    default_branch: string;
+    license: string | null | undefined;
+    url: string;
+}>;
+export declare function listIssues(owner: string, repo: string, state: "open" | "closed" | "all", limit?: number): Promise<{
+    number: number;
+    title: string;
+    state: string;
+    comments: number;
+    url: string;
+}[]>;
+export declare function getIssue(owner: string, repo: string, issue_number: number): Promise<{
+    number: number;
+    title: string;
+    state: string;
+    author: string | undefined;
+    body: string | null | undefined;
+    url: string;
+    comments: {
+        author: string | undefined;
+        body: string | undefined;
+    }[];
+}>;
+export declare function listPullRequests(owner: string, repo: string, state: "open" | "closed" | "all", limit?: number): Promise<{
+    number: number;
+    title: string;
+    state: string;
+    author: string | undefined;
+    draft: boolean | undefined;
+    url: string;
+}[]>;
+export declare function getPullRequest(owner: string, repo: string, pull_number: number): Promise<{
+    number: number;
+    title: string;
+    state: "open" | "closed";
+    author: string;
+    body: string | null;
+    additions: number;
+    deletions: number;
+    changed_files: number;
+    merged: boolean;
+    url: string;
+}>;
+export declare function getFileContents(owner: string, repo: string, p: string, ref?: string): Promise<{
+    type: string;
+    entries: {
+        name: string;
+        type: "dir" | "file" | "submodule" | "symlink";
+        size: number;
+    }[];
+    path?: undefined;
+    size?: undefined;
+    note?: undefined;
+    content?: undefined;
+} | {
+    type: string;
+    path: string;
+    size: number;
+    note: string;
+    entries?: undefined;
+    content?: undefined;
+} | {
+    type: string;
+    path: string;
+    size: number;
+    content: string;
+    entries?: undefined;
+    note?: undefined;
+} | {
+    type: "submodule" | "symlink";
+    entries?: undefined;
+    path?: undefined;
+    size?: undefined;
+    note?: undefined;
+    content?: undefined;
+}>;
+export declare function listNotifications(limit?: number): Promise<{
+    repo: string;
+    subject: string;
+    type: string;
+    reason: string;
+    unread: boolean;
+}[]>;
+export declare function rateLimit(): Promise<{
+    limit: number;
+    remaining: number;
+    reset: string;
+}>;
+export declare function createIssue(owner: string, repo: string, title: string, body?: string): Promise<{
+    number: number;
+    url: string;
+}>;
+export declare function addIssueComment(owner: string, repo: string, issue_number: number, body: string): Promise<{
+    id: number;
+    url: string;
+}>;

package/dist/gh.js

@@ -0,0 +1,109 @@
+/**
+ * GitHub API layer over @octokit/rest. Each call builds an Octokit with the
+ * currently-resolved token (so it picks up a fresh login). Wrappers return
+ * trimmed, token-efficient objects rather than raw API payloads.
+ */
+import { Octokit } from "@octokit/rest";
+import { getToken } from "./auth.js";
+import { DEFAULT_PER_PAGE, VERSION } from "./config.js";
+async function octo() {
+    return new Octokit({ auth: await getToken(), userAgent: `mcp-github/${VERSION}` });
+}
+const cap = (n) => Math.min(Math.max(n ?? DEFAULT_PER_PAGE, 1), 100);
+export async function whoami() {
+    const { data } = await (await octo()).rest.users.getAuthenticated();
+    return { login: data.login, name: data.name, url: data.html_url, public_repos: data.public_repos, private_repos: data.total_private_repos };
+}
+export async function searchRepos(q, limit) {
+    const { data } = await (await octo()).rest.search.repos({ q, per_page: cap(limit) });
+    return data.items.map((r) => ({ full_name: r.full_name, stars: r.stargazers_count, language: r.language, description: r.description, url: r.html_url }));
+}
+export async function searchCode(q, limit) {
+    const { data } = await (await octo()).rest.search.code({ q, per_page: cap(limit) });
+    return data.items.map((i) => ({ repo: i.repository.full_name, path: i.path, url: i.html_url }));
+}
+export async function searchIssues(q, limit) {
+    const { data } = await (await octo()).rest.search.issuesAndPullRequests({ q, per_page: cap(limit) });
+    return data.items.map((i) => ({ repo: i.repository_url.replace("https://api.github.com/repos/", ""), number: i.number, title: i.title, state: i.state, is_pr: !!i.pull_request, url: i.html_url }));
+}
+export async function getRepo(owner, repo) {
+    const { data } = await (await octo()).rest.repos.get({ owner, repo });
+    return {
+        full_name: data.full_name,
+        description: data.description,
+        stars: data.stargazers_count,
+        forks: data.forks_count,
+        open_issues: data.open_issues_count,
+        language: data.language,
+        default_branch: data.default_branch,
+        license: data.license?.spdx_id,
+        url: data.html_url,
+    };
+}
+export async function listIssues(owner, repo, state, limit) {
+    const { data } = await (await octo()).rest.issues.listForRepo({ owner, repo, state, per_page: cap(limit) });
+    return data.filter((i) => !i.pull_request).map((i) => ({ number: i.number, title: i.title, state: i.state, comments: i.comments, url: i.html_url }));
+}
+export async function getIssue(owner, repo, issue_number) {
+    const o = await octo();
+    const { data } = await o.rest.issues.get({ owner, repo, issue_number });
+    const { data: comments } = await o.rest.issues.listComments({ owner, repo, issue_number, per_page: 20 });
+    return {
+        number: data.number,
+        title: data.title,
+        state: data.state,
+        author: data.user?.login,
+        body: data.body,
+        url: data.html_url,
+        comments: comments.map((c) => ({ author: c.user?.login, body: c.body })),
+    };
+}
+export async function listPullRequests(owner, repo, state, limit) {
+    const { data } = await (await octo()).rest.pulls.list({ owner, repo, state, per_page: cap(limit) });
+    return data.map((p) => ({ number: p.number, title: p.title, state: p.state, author: p.user?.login, draft: p.draft, url: p.html_url }));
+}
+export async function getPullRequest(owner, repo, pull_number) {
+    const { data } = await (await octo()).rest.pulls.get({ owner, repo, pull_number });
+    return {
+        number: data.number,
+        title: data.title,
+        state: data.state,
+        author: data.user?.login,
+        body: data.body,
+        additions: data.additions,
+        deletions: data.deletions,
+        changed_files: data.changed_files,
+        merged: data.merged,
+        url: data.html_url,
+    };
+}
+export async function getFileContents(owner, repo, p, ref) {
+    const { data } = await (await octo()).rest.repos.getContent({ owner, repo, path: p, ref });
+    if (Array.isArray(data)) {
+        return { type: "dir", entries: data.map((e) => ({ name: e.name, type: e.type, size: e.size })) };
+    }
+    if (data.type === "file" && "content" in data) {
+        if (data.size > 1024 * 1024)
+            return { type: "file", path: data.path, size: data.size, note: "file too large to inline" };
+        return { type: "file", path: data.path, size: data.size, content: Buffer.from(data.content, "base64").toString("utf8") };
+    }
+    return { type: data.type };
+}
+export async function listNotifications(limit) {
+    const { data } = await (await octo()).rest.activity.listNotificationsForAuthenticatedUser({ per_page: cap(limit) });
+    return data.map((n) => ({ repo: n.repository.full_name, subject: n.subject.title, type: n.subject.type, reason: n.reason, unread: n.unread }));
+}
+export async function rateLimit() {
+    const { data } = await (await octo()).rest.rateLimit.get();
+    const core = data.resources.core;
+    return { limit: core.limit, remaining: core.remaining, reset: new Date(core.reset * 1000).toISOString() };
+}
+export async function createIssue(owner, repo, title, body) {
+    const { data } = await (await octo()).rest.issues.create({ owner, repo, title, body });
+    return { number: data.number, url: data.html_url };
+}
+export async function addIssueComment(owner, repo, issue_number, body) {
+    const { data } = await (await octo()).rest.issues.createComment({ owner, repo, issue_number, body });
+    return { id: data.id, url: data.html_url };
+}
+//# sourceMappingURL=gh.js.map

package/dist/gh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../src/gh.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/**
+ * @abhishekmcp/github — GitHub MCP server.
+ * Tool registration only; auth lives in auth.ts, API calls in gh.ts. Write tools
+ * are omitted when GITHUB_READONLY is set. No auth is required at startup —
+ * tools return clear guidance if the user isn't authenticated yet.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { VERSION, isReadOnly } from "./config.js";
+import { NotAuthenticatedError, authSource, login, logout } from "./auth.js";
+import * as gh from "./gh.js";
+const server = new McpServer({ name: "mcp-github-server", version: VERSION });
+const text = (value) => ({ content: [{ type: "text", text: value }] });
+const json = (v) => text(JSON.stringify(v, null, 2));
+function fail(err) {
+    if (err instanceof NotAuthenticatedError)
+        return text(err.message);
+    const e = err;
+    if (e?.status) {
+        let msg = `GitHub API error ${e.status}: ${e.message}`;
+        if (e.status === 401)
+            msg += " — token invalid/expired; run github_login or check GITHUB_TOKEN.";
+        const h = e.response?.headers;
+        if (e.status === 403 && h?.["x-ratelimit-remaining"] === "0") {
+            msg += ` — rate limit exceeded; resets at ${new Date(Number(h["x-ratelimit-reset"]) * 1000).toISOString()}.`;
+        }
+        return text(msg);
+    }
+    return text(`Error: ${err.message}`);
+}
+const owner = z.string().describe("Repository owner (user or org)");
+const repo = z.string().describe("Repository name");
+const stateEnum = z.enum(["open", "closed", "all"]).optional().describe("Filter by state (default open)");
+// --- Auth tools (always) -------------------------------------------------
+server.registerTool("github_login", {
+    title: "Log in to GitHub",
+    description: "Authenticate via GitHub OAuth device flow. First call returns a code + URL to open; run it again after authorizing to finish. (Or set GITHUB_TOKEN to skip.)",
+    inputSchema: {},
+}, async () => {
+    try {
+        return text((await login()).message);
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("github_logout", { title: "Log out", description: "Clear the cached GitHub token.", inputSchema: {} }, async () => {
+    await logout();
+    return text("Logged out (cached token cleared).");
+});
+server.registerTool("whoami", { title: "Who am I", description: "Show the authenticated GitHub user (and how the token was obtained).", inputSchema: {} }, async () => {
+    try {
+        const me = await gh.whoami();
+        return json({ ...me, auth_source: await authSource() });
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+// --- Search --------------------------------------------------------------
+server.registerTool("search_repos", { title: "Search repositories", description: "Search GitHub repositories (GitHub search syntax).", inputSchema: { query: z.string(), limit: z.number().int().positive().max(100).optional() } }, async ({ query, limit }) => {
+    try {
+        return json(await gh.searchRepos(query, limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("search_code", { title: "Search code", description: "Search code across GitHub (e.g. 'addEventListener repo:owner/name').", inputSchema: { query: z.string(), limit: z.number().int().positive().max(100).optional() } }, async ({ query, limit }) => {
+    try {
+        return json(await gh.searchCode(query, limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("search_issues", { title: "Search issues/PRs", description: "Search issues and pull requests (GitHub search syntax).", inputSchema: { query: z.string(), limit: z.number().int().positive().max(100).optional() } }, async ({ query, limit }) => {
+    try {
+        return json(await gh.searchIssues(query, limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+// --- Repos / issues / PRs (read) -----------------------------------------
+server.registerTool("get_repo", { title: "Get repository", description: "Repository metadata (stars, language, default branch, license).", inputSchema: { owner, repo } }, async ({ owner, repo }) => {
+    try {
+        return json(await gh.getRepo(owner, repo));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("list_issues", { title: "List issues", description: "List a repo's issues (excludes PRs).", inputSchema: { owner, repo, state: stateEnum, limit: z.number().int().positive().max(100).optional() } }, async ({ owner, repo, state, limit }) => {
+    try {
+        return json(await gh.listIssues(owner, repo, state ?? "open", limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("get_issue", { title: "Get issue", description: "An issue's details plus its first comments.", inputSchema: { owner, repo, number: z.number().int().positive() } }, async ({ owner, repo, number }) => {
+    try {
+        return json(await gh.getIssue(owner, repo, number));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("list_pull_requests", { title: "List pull requests", description: "List a repo's pull requests.", inputSchema: { owner, repo, state: stateEnum, limit: z.number().int().positive().max(100).optional() } }, async ({ owner, repo, state, limit }) => {
+    try {
+        return json(await gh.listPullRequests(owner, repo, state ?? "open", limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("get_pull_request", { title: "Get pull request", description: "A PR's details (diff stats, merged state, body).", inputSchema: { owner, repo, number: z.number().int().positive() } }, async ({ owner, repo, number }) => {
+    try {
+        return json(await gh.getPullRequest(owner, repo, number));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("get_file_contents", { title: "Get file contents", description: "Read a file (decoded) or list a directory in a repo, at an optional ref.", inputSchema: { owner, repo, path: z.string(), ref: z.string().optional().describe("Branch, tag, or commit SHA") } }, async ({ owner, repo, path, ref }) => {
+    try {
+        return json(await gh.getFileContents(owner, repo, path, ref));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("list_notifications", { title: "List notifications", description: "Your unread GitHub notifications.", inputSchema: { limit: z.number().int().positive().max(100).optional() } }, async ({ limit }) => {
+    try {
+        return json(await gh.listNotifications(limit));
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+server.registerTool("rate_limit", { title: "Rate limit", description: "Your remaining GitHub API requests and reset time.", inputSchema: {} }, async () => {
+    try {
+        return json(await gh.rateLimit());
+    }
+    catch (err) {
+        return fail(err);
+    }
+});
+// --- Write tools (omitted when GITHUB_READONLY) --------------------------
+if (!isReadOnly()) {
+    server.registerTool("create_issue", {
+        title: "Create issue",
+        description: "Open a new issue in a repository.",
+        inputSchema: { owner, repo, title: z.string(), body: z.string().optional() },
+        annotations: { destructiveHint: true },
+    }, async ({ owner, repo, title, body }) => {
+        try {
+            return json(await gh.createIssue(owner, repo, title, body));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool("add_issue_comment", {
+        title: "Comment on issue",
+        description: "Add a comment to an issue or pull request.",
+        inputSchema: { owner, repo, number: z.number().int().positive(), body: z.string() },
+        annotations: { destructiveHint: true },
+    }, async ({ owner, repo, number, body }) => {
+        try {
+            return json(await gh.addIssueComment(owner, repo, number, body));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+// --- Startup -------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`mcp-github-server v${VERSION} running${isReadOnly() ? " (read-only)" : ""}.`);
+}
+main().catch((err) => {
+    console.error("Fatal error starting mcp-github-server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@abhishekmcp/github",
+  "version": "0.1.0",
+  "description": "MCP server for GitHub — search repos/code/issues, read repos/issues/PRs/files, and create issues, authenticated via OAuth device flow or a token, from any MCP client.",
+  "mcpName": "io.github.Abhishekkumar2021/github",
+  "type": "module",
+  "bin": {
+    "mcp-github": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "github",
+    "octokit",
+    "claude"
+  ],
+  "author": "Abhishek (https://github.com/Abhishekkumar2021)",
+  "license": "MIT",
+  "homepage": "https://github.com/Abhishekkumar2021/mcp-suite/tree/main/servers/github#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abhishekkumar2021/mcp-suite.git",
+    "directory": "servers/github"
+  },
+  "bugs": {
+    "url": "https://github.com/Abhishekkumar2021/mcp-suite/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@octokit/rest": "^21.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}