github-pro-mcp 0.0.2 → 0.0.4

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "github-pro-mcp",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "MCP server providing GitHub API access with hybrid REST + GraphQL support",
-  "main": "dist/index.js",
+  "main": "dist-package/index.js",
   "bin": {
-    "github-pro-mcp": "dist/index.js"
+    "github-pro-mcp": "dist-package/index.js"
   },
   "files": [
-    "dist"
+    "dist-package/index.js",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
+    "build": "tsc -b .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "bundle": "node scripts/build.mjs",
+    "start": "node dist-package/index.js",
+    "dev": "tsc -b . --watch",
     "test": "node --test --test-global-setup='src/__tests__/setup.mjs' --test-concurrency=1 'src/__tests__/**/*.test.mjs'",
     "test:unit": "node --test 'src/__tests__/{retry,circuit_breaker,rate_limit}.test.mjs'",
     "test:repos": "node --test --test-global-setup='src/__tests__/setup.mjs' 'src/__tests__/repos.test.mjs'",
@@ -25,15 +29,15 @@
     "test:consistency": "node --test --test-global-setup='src/__tests__/setup.mjs' 'src/__tests__/consistency.test.mjs'",
     "test:docker": "node --test 'test/docker/**/*.test.mjs'",
     "test:npm": "node --test 'test/integration/**/*.test.mjs'",
-    "test:all": "npm test && npm run test:docker && npm run test:npm",
+    "test:all": "npm test && npm run test:readonly && npm run test:docker && npm run test:npm",
+    "test:readonly": "node --test 'test/readonly.test.mjs'",
     "test:coverage": "node --experimental-test-coverage --test --test-global-setup='src/__tests__/setup.mjs' 'src/__tests__/**/*.test.mjs'",
     "test:inspector": "npx @modelcontextprotocol/inspector node dist/index.js",
-    "dev": "tsc --watch",
-    "prepack": "npm run build",
+    "prepack": "npm run build && npm run bundle",
     "docker:build": "make docker-build",
     "docker:build:local": "make docker-build-local",
     "docker:push": "make docker-push",
-    "publish:npm": "npm run build && npm test && npm publish",
+    "publish:npm": "npm run build && npm test && ./scripts/publish-npm.sh",
     "publish:all": "npm run publish:npm && npm run docker:push"
   },
   "keywords": [
@@ -44,7 +48,7 @@
     "graphql"
   ],
   "author": "Anant Anand Gupta",
-  "license": "ISC",
+  "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/anantanandgupta/mcp-servers.git"
@@ -52,9 +56,12 @@
   "bugs": {
     "url": "https://github.com/anantanandgupta/mcp-servers/issues"
   },
-  "homepage": "https://github.com/anantanandgupta/mcp-servers#readme",
+  "homepage": "https://mcp.anantanandgupta.net/github-pro-mcp/",
   "type": "module",
-  "dependencies": {
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@octokit/core": "^6.1.2",
     "@octokit/plugin-paginate-graphql": "^5.2.2",
@@ -62,11 +69,10 @@
     "@octokit/plugin-throttling": "^10.0.0",
     "@octokit/request-error": "^6.0.0",
     "@octokit/types": "^13.0.0",
+    "@types/node": "^25.9.1",
     "bottleneck": "^2.19.5",
+    "esbuild": "^0.28.2",
+    "typescript": "^6.0.3",
     "zod": "^3.25.76"
-  },
-  "devDependencies": {
-    "@types/node": "^25.9.1",
-    "typescript": "^6.0.3"
   }
 }

package/dist/client.d.ts

@@ -1,28 +0,0 @@
-import { Octokit } from "@octokit/core";
-import type { Api } from "@octokit/plugin-rest-endpoint-methods";
-export type OctokitWithRest = Octokit & {
-    rest: Api["rest"];
-};
-/**
- * Creates a lazy singleton Octokit client with all plugins configured.
- *
- * The singleton preserves throttling queue state across calls.
- * The returned client wraps all REST requests through:
- *   circuit breaker → retry → throttling → GitHub API
- *
- * Rate limit headers from responses are automatically tracked
- * via `updateRateLimits()`.
- */
-export declare function createClient(): OctokitWithRest;
-/**
- * Execute a raw GraphQL query against the GitHub API.
- * The query is wrapped with circuit breaker and retry protection.
- */
-export declare function gql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
-/**
- * Derive the web UI base URL from the GITHUB_HOST env var.
- * For api.github.com, returns https://github.com.
- * For GHES, derives from the hostname.
- */
-export declare function getWebBaseUrl(): string;
-export declare function gqlPaginate<T>(query: string, variables?: Record<string, unknown>): Promise<T[]>;

package/dist/client.js

@@ -1,85 +0,0 @@
-import { Octokit } from "@octokit/core";
-import { restEndpointMethods } from "@octokit/plugin-rest-endpoint-methods";
-import { paginateGraphQL } from "@octokit/plugin-paginate-graphql";
-import { throttling } from "@octokit/plugin-throttling";
-import { withRetry } from "./utils/retry.js";
-import { withCircuitBreaker } from "./utils/circuitBreaker.js";
-import { createLogger } from "./utils/logger.js";
-import { updateRateLimits } from "./utils/rateLimit.js";
-const log = createLogger("client");
-const MyOctokit = Octokit
-    .plugin(restEndpointMethods)
-    .plugin(paginateGraphQL)
-    .plugin(throttling);
-let cachedClient = null;
-/**
- * Creates a lazy singleton Octokit client with all plugins configured.
- *
- * The singleton preserves throttling queue state across calls.
- * The returned client wraps all REST requests through:
- *   circuit breaker → retry → throttling → GitHub API
- *
- * Rate limit headers from responses are automatically tracked
- * via `updateRateLimits()`.
- */
-export function createClient() {
-    if (cachedClient)
-        return cachedClient;
-    const token = process.env.GITHUB_PERSONAL_ACCESS_TOKEN;
-    if (!token) {
-        throw new Error("GITHUB_PERSONAL_ACCESS_TOKEN environment variable is not set. " +
-            "Create a token at https://github.com/settings/tokens " +
-            "and set it as GITHUB_PERSONAL_ACCESS_TOKEN in your environment.");
-    }
-    const onRateLimitStrategy = process.env.GITHUB_THROTTLE_ON_RATE_LIMIT !== "queue";
-    const octokit = new MyOctokit({
-        auth: token,
-        baseUrl: process.env.GITHUB_HOST ?? "https://api.github.com",
-        throttle: {
-            onRateLimit: (retryAfter, options) => {
-                log.warn(`Primary rate limit hit. Retrying after ${retryAfter}s. ` +
-                    `Request: ${options.method} ${options.url}`);
-                return onRateLimitStrategy;
-            },
-            onSecondaryRateLimit: (retryAfter, options) => {
-                log.warn(`Secondary rate limit hit. Retrying after ${retryAfter}s. ` +
-                    `Request: ${options.method} ${options.url}`);
-                return process.env.GITHUB_THROTTLE_ON_SECONDARY_RATE_LIMIT !== "queue";
-            },
-        },
-    });
-    octokit.hook.after("request", (response) => {
-        if (response?.headers) {
-            updateRateLimits(response.headers);
-        }
-    });
-    octokit.hook.wrap("request", async (request, options) => {
-        const label = `REST ${options.method} ${options.url}`;
-        return withCircuitBreaker(() => withRetry(() => Promise.resolve(request(options)), label), "github-rest");
-    });
-    cachedClient = octokit;
-    return octokit;
-}
-/**
- * Execute a raw GraphQL query against the GitHub API.
- * The query is wrapped with circuit breaker and retry protection.
- */
-export async function gql(query, variables) {
-    const octokit = createClient();
-    return withCircuitBreaker(() => withRetry(() => octokit.graphql(query, variables), `GraphQL ${query.trim().split("\n")[0].slice(0, 60)}`), "github-graphql");
-}
-/**
- * Derive the web UI base URL from the GITHUB_HOST env var.
- * For api.github.com, returns https://github.com.
- * For GHES, derives from the hostname.
- */
-export function getWebBaseUrl() {
-    const apiUrl = new URL(process.env.GITHUB_HOST ?? "https://api.github.com");
-    if (apiUrl.hostname === "api.github.com")
-        return "https://github.com";
-    return `https://${apiUrl.hostname}`;
-}
-export async function gqlPaginate(query, variables) {
-    const octokit = createClient();
-    return withCircuitBreaker(() => withRetry(() => octokit.graphql.paginate(query, variables), `GraphQL paginate ${query.trim().split("\n")[0].slice(0, 60)}`), "github-graphql");
-}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-const require = createRequire(import.meta.url);
-const pkg = require("../package.json");
-import { registerAuthGetCurrentLogin, registerFileGetContent, registerProfileGet, registerOwnerListRepository, registerFileCreateUpdate, registerFileDelete, registerCodeSearch, registerRepositorySearch, } from "./tools/repos.js";
-import { registerOrganizationSearch, registerOwnerListIssueType, registerOwnerListOrganization, } from "./tools/organizations.js";
-import { registerPullRequestRead, registerPullRequestCreate, registerPullRequestMerge, } from "./tools/pull_requests.js";
-import { registerIssueRead, registerIssueList, registerIssueSearch, registerIssueAddComment, registerSubIssueWrite, registerIssueCreate, registerIssueClose, registerIssueReopen, registerIssueUpdate, registerIssueAddLabel, registerIssueRemoveLabel, } from "./tools/issues.js";
-import { registerOwnerListIssueField, registerIssueGetFieldValue, registerIssueSetFieldValue, } from "./tools/issue_fields.js";
-import { registerLabelList, registerLabelWrite, } from "./tools/labels.js";
-import { registerOwnerListProject, registerProjectsGet, registerProjectsWrite, } from "./tools/projects.js";
-import { registerServerInfo } from "./tools/server.js";
-const server = new McpServer({ name: pkg.name, version: pkg.version }, { capabilities: { tools: {} } });
-const serverMeta = {
-    name: pkg.name,
-    version: pkg.version,
-    description: pkg.description,
-    author: pkg.author,
-    license: pkg.license,
-    repository: pkg.repository?.url ?? "",
-    homepage: pkg.homepage ?? "",
-    bug_tracker: pkg.bugs?.url ?? "",
-    bin: pkg.bin ?? {},
-    tool_count: 34,
-};
-registerAuthGetCurrentLogin(server);
-registerFileGetContent(server);
-registerFileDelete(server);
-registerProfileGet(server);
-registerOwnerListRepository(server);
-registerFileCreateUpdate(server);
-registerCodeSearch(server);
-registerRepositorySearch(server);
-registerOrganizationSearch(server);
-registerOwnerListIssueType(server);
-registerOwnerListOrganization(server);
-registerPullRequestRead(server);
-registerPullRequestCreate(server);
-registerPullRequestMerge(server);
-registerIssueRead(server);
-registerIssueList(server);
-registerIssueSearch(server);
-registerIssueAddComment(server);
-registerSubIssueWrite(server);
-registerIssueCreate(server);
-registerIssueClose(server);
-registerIssueReopen(server);
-registerIssueUpdate(server);
-registerIssueAddLabel(server);
-registerIssueRemoveLabel(server);
-registerOwnerListIssueField(server);
-registerIssueGetFieldValue(server);
-registerIssueSetFieldValue(server);
-registerLabelList(server);
-registerLabelWrite(server);
-registerOwnerListProject(server);
-registerProjectsGet(server);
-registerProjectsWrite(server);
-registerServerInfo(server, serverMeta);
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("github-pro-mcp running on stdio");
-}
-main().catch((err) => {
-    console.error("Fatal error:", err);
-    process.exit(1);
-});

package/dist/tools/issue_fields.d.ts

@@ -1,4 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerOwnerListIssueField(server: McpServer): void;
-export declare function registerIssueGetFieldValue(server: McpServer): void;
-export declare function registerIssueSetFieldValue(server: McpServer): void;

package/dist/tools/issue_fields.js

@@ -1,108 +0,0 @@
-import * as z from "zod/v4";
-import { createClient } from "../client.js";
-import { handleGitHubError } from "../utils/errors.js";
-import { requireOrg, validatePinnedOwnerRepo } from "../utils/validation.js";
-import { OwnerRepoSchema, IssueNumberSchema } from "../utils/types.js";
-export function registerOwnerListIssueField(server) {
-    server.registerTool("owner_list_issue_field", {
-        description: "List all issue field definitions for an organization (e.g., Priority, Effort, Start date, Target date). Owner must be an organization.",
-        inputSchema: z.object({
-            owner: z.string().min(1).describe("Organization owner"),
-        }),
-    }, async ({ owner }) => {
-        try {
-            const pinErr = validatePinnedOwnerRepo(owner);
-            if (pinErr)
-                return pinErr;
-            const octokit = createClient();
-            const orgErr = await requireOrg(owner);
-            if (orgErr)
-                return orgErr;
-            const { data } = await octokit.request('GET /orgs/{owner}/issue-fields', { owner });
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-        }
-        catch (err) {
-            return handleGitHubError(err);
-        }
-    });
-}
-export function registerIssueGetFieldValue(server) {
-    server.registerTool("issue_get_field_value", {
-        description: "Get the current field values (Priority, Effort, dates, etc.) assigned to an issue.",
-        inputSchema: OwnerRepoSchema.extend({
-            issue_number: IssueNumberSchema,
-        }),
-    }, async ({ owner, repo, issue_number }) => {
-        try {
-            const pinErr = validatePinnedOwnerRepo(owner, repo);
-            if (pinErr)
-                return pinErr;
-            const octokit = createClient();
-            const { data } = await octokit.rest.issues.get({ owner, repo, issue_number });
-            const issueData = data;
-            return { content: [{ type: "text", text: JSON.stringify(issueData.issue_field_values ?? [], null, 2) }] };
-        }
-        catch (err) {
-            return handleGitHubError(err);
-        }
-    });
-}
-export function registerIssueSetFieldValue(server) {
-    server.registerTool("issue_set_field_value", {
-        description: "Set field values (Priority, Effort, dates, etc.) on an issue. Accepts either field_id (numeric ID) or field_name (e.g. 'Priority'). For single-select fields, value can be the option name (e.g. 'Medium') or option ID. For dates, use ISO 8601 (e.g. '2026-06-15'). Pass null to clear a field.",
-        inputSchema: OwnerRepoSchema.extend({
-            issue_number: IssueNumberSchema,
-            fields: z.array(z.object({
-                field_id: z.number().int().positive().optional().describe("Field ID from owner_list_issue_field"),
-                field_name: z.string().optional().describe("Field name (e.g. 'Priority') as alternative to field_id"),
-                value: z.union([z.string(), z.number(), z.null()]).describe("Field value: option name/ID for single-select, ISO date for dates, number for numeric fields, or null to clear"),
-            })).min(1).describe("Array of field updates"),
-        }),
-    }, async ({ owner, repo, issue_number, fields }) => {
-        try {
-            const pinErr = validatePinnedOwnerRepo(owner, repo);
-            if (pinErr)
-                return pinErr;
-            const octokit = createClient();
-            const nameFields = fields.filter((f) => !f.field_id && f.field_name);
-            let fieldDefs = null;
-            if (nameFields.length > 0) {
-                const { data } = await octokit.request('GET /orgs/{owner}/issue-fields', { owner });
-                fieldDefs = data;
-            }
-            const resolvedFields = [];
-            for (const f of fields) {
-                let fieldId = f.field_id;
-                if (!fieldId && f.field_name) {
-                    const matching = fieldDefs.find((fd) => fd.name.toLowerCase() === f.field_name.toLowerCase());
-                    if (!matching) {
-                        return {
-                            content: [{ type: "text", text: `Field "${f.field_name}" not found. Available fields: ${fieldDefs.map((fd) => fd.name).join(", ")}` }],
-                            isError: true,
-                        };
-                    }
-                    fieldId = matching.id;
-                }
-                if (!fieldId) {
-                    return {
-                        content: [{ type: "text", text: "Either field_id or field_name is required for each field update." }],
-                        isError: true,
-                    };
-                }
-                resolvedFields.push({ field_id: fieldId, value: f.value });
-            }
-            const response = await octokit.request('PATCH /repos/{owner}/{repo}/issues/{issue_number}', {
-                owner, repo, issue_number,
-                issue_field_values: resolvedFields,
-            });
-            const data = response.data;
-            return { content: [{ type: "text", text: JSON.stringify({
-                            success: true,
-                            issue_field_values: data.issue_field_values ?? [],
-                        }, null, 2) }] };
-        }
-        catch (err) {
-            return handleGitHubError(err);
-        }
-    });
-}

package/dist/tools/issues.d.ts

@@ -1,12 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerIssueRead(server: McpServer): void;
-export declare function registerIssueList(server: McpServer): void;
-export declare function registerIssueSearch(server: McpServer): void;
-export declare function registerIssueAddComment(server: McpServer): void;
-export declare function registerSubIssueWrite(server: McpServer): void;
-export declare function registerIssueCreate(server: McpServer): void;
-export declare function registerIssueClose(server: McpServer): void;
-export declare function registerIssueReopen(server: McpServer): void;
-export declare function registerIssueUpdate(server: McpServer): void;
-export declare function registerIssueAddLabel(server: McpServer): void;
-export declare function registerIssueRemoveLabel(server: McpServer): void;