projectpulse-mcp 1.0.0

package/dist/tools/get-repo-health.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { getOctokit } from '../github/client.js';
+import { executeGetRepoHealth } from './get-repo-health.js';
+// Mock intero modulo
+vi.mock('../github/client.js');
+describe('executeGetRepoHealth', () => {
+    beforeEach(() => {
+        vi.resetAllMocks(); // pulisci mock tra un test e l'altro
+    });
+    it('should return repo data for valid repo', async () => {
+        // 1. Configura mock: getOctokit() ritorna oggetto con repos.get()
+        const mockReposGet = vi.fn().mockResolvedValue({
+            data: {
+                full_name: 'test/repo',
+                description: 'test description',
+                stargazers_count: 100,
+                open_issues_count: 5,
+                language: 'TypeScript',
+                license: { spdx_id: 'MIT' },
+                pushed_at: '2023-10-01T00:00:00Z',
+                default_branch: 'main',
+                archived: false,
+                forks_count: 10
+            }
+        });
+        vi.mocked(getOctokit).mockReturnValue({
+            repos: { get: mockReposGet }
+        });
+        // 2. Chiama il tool
+        const result = await executeGetRepoHealth({ owner: 'test', repo: 'repo' });
+        // 3. Verifica output
+        expect(mockReposGet).toHaveBeenCalledWith({ owner: 'test', repo: 'repo' });
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe('text');
+        const parsedText = JSON.parse(result.content[0].text);
+        expect(parsedText).toEqual({
+            full_name: 'test/repo',
+            description: 'test description',
+            stargazers_count: 100,
+            open_issues_count: 5,
+            language: 'TypeScript',
+            license: 'MIT',
+            pushed_at: '2023-10-01T00:00:00Z',
+            default_branch: 'main',
+            archived: false,
+            forks_count: 10
+        });
+    });
+    it('should handle 404 for non-existent repo', async () => {
+        // 1. Configura mock: repos.get() lancia errore con status 404
+        const notFoundError = new Error('Not Found');
+        notFoundError.status = 404;
+        const mockReposGet = vi.fn().mockRejectedValue(notFoundError);
+        vi.mocked(getOctokit).mockReturnValue({
+            repos: { get: mockReposGet }
+        });
+        // 2. Chiama il tool
+        const result = await executeGetRepoHealth({ owner: 'test', repo: 'not-found' });
+        // 3. Verifica che ritorna messaggio errore, non throw
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe('text');
+        const parsedText = JSON.parse(result.content[0].text);
+        expect(parsedText).toEqual({
+            error: "Repository not found",
+            details: "Not Found"
+        });
+    });
+    it('should throw error for non-404 errors', async () => {
+        const serverError = new Error('Internal Server Error');
+        serverError.status = 500;
+        const mockReposGet = vi.fn().mockRejectedValue(serverError);
+        vi.mocked(getOctokit).mockReturnValue({
+            repos: { get: mockReposGet }
+        });
+        await expect(executeGetRepoHealth({ owner: 'test', repo: 'error-repo' }))
+            .rejects
+            .toThrow('Internal Server Error');
+    });
+});
+//# sourceMappingURL=get-repo-health.test.js.map

package/dist/tools/get-repo-health.test.js.map

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

package/dist/types/health.d.ts

@@ -0,0 +1,16 @@
+type Grade = 'A' | 'B' | 'C' | 'D' | 'F';
+type CategoryScore = {
+    score: number;
+    weight: number;
+    detail: string;
+};
+type HealthReport = {
+    repo: string;
+    score: number;
+    grade: Grade;
+    breakdown: Record<string, CategoryScore>;
+    suggestions: string[];
+    checkedAt: string;
+};
+export { Grade, CategoryScore, HealthReport };
+//# sourceMappingURL=health.d.ts.map

package/dist/types/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/types/health.ts"],"names":[],"mappings":"AACA,KAAK,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAGzC,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAA;AAGD,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAA;AAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}

package/dist/types/health.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.js.map

package/dist/types/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/types/health.ts"],"names":[],"mappings":""}

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../src/vitest.config.ts"],"names":[],"mappings":";AAEA,wBAIG"}

package/dist/vitest.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+    test: {
+        globals: true,
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../src/vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;KAChB;CACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "projectpulse-mcp",
+  "description": "MCP Server for GitHub repository health monitoring",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "github",
+    "health",
+    "monitoring",
+    "ai"
+  ],
+  "author": "Alessandro Chiodo",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@octokit/rest": "^22.0.1",
+    "dotenv": "^17.4.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "bin": {
+    "projectpulse-mcp": "./bin/projectpulse-mcp.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ]
+}