npm - @gitstar-ai/mcp - Versions diffs - 0.2.0 - Mend

@gitstar-ai/mcp 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,85 @@
+# @gitstar-ai/mcp
+GitHub actions inside any AI tool, powered by [Gitstar](https://tinkling.vercel.app).
+## Setup
+### Claude Desktop
+Add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "gitstar": {
+      "command": "npx",
+      "args": ["-y", "@gitstar-ai/mcp"]
+    }
+  }
+}
+```
+### Claude Code (CLI)
+Add to `.claude/settings.json`:
+```json
+{
+  "mcpServers": {
+    "gitstar": {
+      "command": "npx",
+      "args": ["-y", "@gitstar-ai/mcp"]
+    }
+  }
+}
+```
+### Cursor
+Add to `.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "gitstar": {
+      "command": "npx",
+      "args": ["-y", "@gitstar-ai/mcp"]
+    }
+  }
+}
+```
+### Login
+```bash
+npx @gitstar-ai/mcp login
+```
+This opens your browser to authenticate with GitHub via Gitstar. One-time setup.
+## Tools
+| Tool | Description |
+|------|-------------|
+| `gitstar_get_feed` | Narrated activity feed for a repo |
+| `gitstar_get_repo` | Repo metadata and stats |
+| `gitstar_get_pr` | PR details, diff, and files |
+| `gitstar_get_pr_checks` | CI/CD check statuses |
+| `gitstar_get_issue` | Issue details and timeline |
+| `gitstar_comment_pr` | Comment on a PR |
+| `gitstar_comment_issue` | Comment on an issue |
+| `gitstar_review_pr` | Approve or request changes on a PR |
+| `gitstar_merge_pr` | Merge a PR |
+| `gitstar_close_pr` | Close a PR |
+| `gitstar_close_issue` | Close an issue |
+| `gitstar_search` | Search repos and users |
+| `gitstar_trending` | Trending repos |
+## Example Prompts
+- "Show me what's happening in facebook/react"
+- "Review PR #42 in vercel/next.js for security issues"
+- "What's the CI status on PR #15?"
+- "Merge PR #10 using squash"
+- "Close issue #33, it's a duplicate"
+- "What repos are trending?"

package/dist/auth.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import type { AuthData } from './types.js';
+export declare function getApiUrl(): string;
+export declare function getToken(): AuthData | null;
+export declare function saveToken(data: AuthData): void;
+export declare function login(): Promise<void>;

package/dist/auth.js ADDED Viewed

@@ -0,0 +1,87 @@
+import { createServer } from 'http';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const GITSTAR_DIR = join(homedir(), '.gitstar');
+const AUTH_FILE = join(GITSTAR_DIR, 'auth.json');
+const CONFIG_FILE = join(GITSTAR_DIR, 'config.json');
+const DEFAULT_API_URL = 'https://www.gitstar.ai';
+function ensureDir() {
+    if (!existsSync(GITSTAR_DIR)) {
+        mkdirSync(GITSTAR_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+export function getApiUrl() {
+    try {
+        const config = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+        return config.api_url || DEFAULT_API_URL;
+    }
+    catch {
+        return DEFAULT_API_URL;
+    }
+}
+export function getToken() {
+    try {
+        const data = JSON.parse(readFileSync(AUTH_FILE, 'utf-8'));
+        if (!data.key || !data.login)
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveToken(data) {
+    ensureDir();
+    writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });
+}
+export async function login() {
+    const apiUrl = getApiUrl();
+    return new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            const url = new URL(req.url, `http://localhost`);
+            if (url.pathname === '/callback') {
+                const key = url.searchParams.get('key');
+                const login = url.searchParams.get('login');
+                if (key && login) {
+                    saveToken({ key, login });
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end('<html><body><h1>Logged in to Gitstar!</h1><p>You can close this window.</p></body></html>');
+                    server.close();
+                    console.log(`Logged in as ${login}`);
+                    resolve();
+                }
+                else {
+                    res.writeHead(400, { 'Content-Type': 'text/html' });
+                    res.end('<html><body><h1>Login failed</h1><p>Missing API key. Try again.</p></body></html>');
+                    server.close();
+                    reject(new Error('Login failed: no API key received'));
+                }
+            }
+        });
+        server.listen(9876, () => {
+            const addr = server.address();
+            const port = typeof addr === 'object' && addr ? addr.port : 9876;
+            const callbackUrl = encodeURIComponent(`http://localhost:${port}/callback`);
+            const authUrl = `${apiUrl}/auth/mcp?callback=${callbackUrl}`;
+            console.log(`Opening browser for login...`);
+            console.log(`If browser doesn't open, visit: ${authUrl}`);
+            import('open').then(({ default: open }) => open(authUrl));
+        });
+        server.on('error', () => {
+            server.listen(0, () => {
+                const addr = server.address();
+                const port = typeof addr === 'object' && addr ? addr.port : 0;
+                const callbackUrl = encodeURIComponent(`http://localhost:${port}/callback`);
+                const authUrl = `${apiUrl}/auth/mcp?callback=${callbackUrl}`;
+                console.log(`Opening browser for login...`);
+                console.log(`If browser doesn't open, visit: ${authUrl}`);
+                import('open').then(({ default: open }) => open(authUrl));
+            });
+        });
+        setTimeout(() => {
+            server.close();
+            reject(new Error('Login timed out after 5 minutes'));
+        }, 5 * 60 * 1000);
+    });
+}

package/dist/index.d.ts ADDED Viewed

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

package/dist/index.js ADDED Viewed

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { z } from 'zod';
+import { createRemoteTransport } from './proxy.js';
+import { getToken, getApiUrl, login } from './auth.js';
+function jsonSchemaToZod(prop, required) {
+    let schema;
+    const enumValues = prop.enum;
+    if (enumValues && enumValues.length > 0) {
+        schema = z.enum(enumValues);
+    }
+    else {
+        switch (prop.type) {
+            case 'number':
+            case 'integer':
+                schema = z.number();
+                break;
+            case 'boolean':
+                schema = z.boolean();
+                break;
+            case 'array':
+                schema = z.array(z.unknown());
+                break;
+            case 'object':
+                schema = z.record(z.unknown());
+                break;
+            default:
+                schema = z.string();
+        }
+    }
+    if (prop.description) {
+        schema = schema.describe(prop.description);
+    }
+    if (!required) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args[0] === 'login') {
+        try {
+            await login();
+            process.exit(0);
+        }
+        catch (err) {
+            console.error('Login failed:', err.message);
+            process.exit(1);
+        }
+    }
+    const auth = getToken();
+    if (!auth) {
+        console.error('Not logged in. Run: npx @gitstar-ai/mcp login');
+        process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    // Create local MCP server that proxies to the remote HTTP server
+    const server = new McpServer({
+        name: 'gitstar',
+        version: '0.2.0',
+    });
+    // Connect to remote server as a client
+    const remoteTransport = createRemoteTransport(auth.key, apiUrl);
+    const client = new Client({ name: 'gitstar-proxy', version: '0.2.0' });
+    await client.connect(remoteTransport);
+    // Get available tools from remote and register them locally as proxies
+    const { tools } = await client.listTools();
+    for (const tool of tools) {
+        const properties = (tool.inputSchema?.properties ?? {});
+        const requiredFields = (tool.inputSchema?.required ?? []);
+        const shape = {};
+        for (const [key, prop] of Object.entries(properties)) {
+            shape[key] = jsonSchemaToZod(prop, requiredFields.includes(key));
+        }
+        server.tool(tool.name, tool.description || '', shape, async (params) => {
+            const result = await client.callTool({ name: tool.name, arguments: params });
+            return result;
+        });
+    }
+    // Connect local server to stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});

package/dist/proxy.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
2	+ export declare function createRemoteTransport(apiKey: string, apiUrl: string): StreamableHTTPClientTransport;

package/dist/proxy.js ADDED Viewed

@@ -0,0 +1,10 @@
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+export function createRemoteTransport(apiKey, apiUrl) {
+    return new StreamableHTTPClientTransport(new URL(`${apiUrl}/mcp`), {
+        requestInit: {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+        },
+    });
+}

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export interface AuthData {
+    key: string;
+    login: string;
+}
+export interface GitstarConfig {
+    api_url: string;
+}

package/dist/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/package.json ADDED Viewed

@@ -0,0 +1,31 @@
+{
+  "name": "@gitstar-ai/mcp",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Gitstar MCP server — interact with GitHub through Gitstar from Claude, Cursor, and other AI tools",
+  "bin": {
+    "gitstar-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "login": "node dist/index.js login"
+  },
+  "keywords": ["mcp", "github", "gitstar", "claude", "cursor", "ai"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "open": "^10.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": ["dist"]
+}