@grafema/mcp 0.1.0-alpha.3 → 0.1.0-alpha.5

package/README.md

@@ -77,6 +77,34 @@ trace_data_flow({ from: "req.body", file: "api/users.js" })
 check_invariant("violation(X) :- node(X, 'CALL'), attr(X, 'name', 'eval')")
 ```
 
+## Configuration
+
+### GitHub Token (for bug reporting)
+
+The `report_issue` tool can automatically create GitHub issues if `GITHUB_TOKEN` is set.
+
+**Option 1: In `.mcp.json`**
+```json
+{
+  "mcpServers": {
+    "grafema": {
+      "command": "npx",
+      "args": ["@grafema/mcp", "--project", "."],
+      "env": {
+        "GITHUB_TOKEN": "ghp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+**Option 2: Environment variable**
+```bash
+export GITHUB_TOKEN=ghp_your_token_here
+```
+
+To create a token: https://github.com/settings/tokens/new (needs `repo` scope for public repos, or `public_repo` for public only).
+
 ## License
 
 Apache-2.0

package/dist/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAKpB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA2E9E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiD9E;AAID,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DhF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CxF;AAID,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBxF;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC,CAYnE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAe1D;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB9E;AAID;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6D1F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAyChE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwG1F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8B1F;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAalF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwE5F;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAiEvG"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAKpB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA2E9E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiD9E;AAID,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DhF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CxF;AAID,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBxF;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC,CAYnE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAe1D;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB9E;AAID;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6D1F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAyChE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwG1F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8B1F;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAalF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwE5F;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAkEvG"}

package/dist/handlers.js

@@ -688,7 +688,9 @@ Rule: violation(X) :- node(X, "CALL"), attr(X, "name", "eval").
 // === BUG REPORTING ===
 export async function handleReportIssue(args) {
     const { title, description, context, labels = ['bug'] } = args;
-    const githubToken = process.env.GITHUB_TOKEN;
+    // Use user's token if provided, otherwise fall back to project's issue-only token
+    const GRAFEMA_ISSUE_TOKEN = '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';
+    const githubToken = process.env.GITHUB_TOKEN || GRAFEMA_ISSUE_TOKEN;
     const repo = 'Disentinel/grafema';
     // Build issue body
     const body = `## Description
@@ -739,9 +741,8 @@ ${context ? `## Context\n\`\`\`\n${context}\n\`\`\`\n` : ''}
     const encodedBody = encodeURIComponent(body);
     const encodedLabels = encodeURIComponent(labels.join(','));
     const directUrl = `${issueUrl}?title=${encodedTitle}&body=${encodedBody}&labels=${encodedLabels}`;
-    return textResult(`⚠️ GITHUB_TOKEN not configured. Please create the issue manually:\n\n` +
+    return textResult(`⚠️ Failed to create issue automatically. Please create it manually:\n\n` +
         `**Quick link** (may truncate long descriptions):\n${directUrl}\n\n` +
         `**Or copy this template to** ${issueUrl}:\n\n` +
-        `---\n**Title:** ${title}\n\n${body}\n---\n\n` +
-        `To enable automatic issue creation, set GITHUB_TOKEN environment variable.`);
+        `---\n**Title:** ${title}\n\n${body}\n---`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafema/mcp",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.5",
   "description": "MCP server for Grafema code analysis toolkit",
   "type": "module",
   "main": "./dist/server.js",
@@ -38,8 +38,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
     "ajv": "^8.17.1",
-    "@grafema/core": "0.1.0-alpha.3",
-    "@grafema/types": "0.1.0-alpha.3"
+    "@grafema/core": "0.1.0-alpha.5",
+    "@grafema/types": "0.1.0-alpha.5"
   },
   "devDependencies": {
     "@types/node": "^25.0.8",

package/src/handlers.ts

@@ -852,7 +852,9 @@ Rule: violation(X) :- node(X, "CALL"), attr(X, "name", "eval").
 
 export async function handleReportIssue(args: import('./types.js').ReportIssueArgs): Promise<ToolResult> {
   const { title, description, context, labels = ['bug'] } = args;
-  const githubToken = process.env.GITHUB_TOKEN;
+  // Use user's token if provided, otherwise fall back to project's issue-only token
+  const GRAFEMA_ISSUE_TOKEN = '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';
+  const githubToken = process.env.GITHUB_TOKEN || GRAFEMA_ISSUE_TOKEN;
   const repo = 'Disentinel/grafema';
 
   // Build issue body
@@ -909,10 +911,9 @@ ${context ? `## Context\n\`\`\`\n${context}\n\`\`\`\n` : ''}
   const directUrl = `${issueUrl}?title=${encodedTitle}&body=${encodedBody}&labels=${encodedLabels}`;
 
   return textResult(
-    `⚠️ GITHUB_TOKEN not configured. Please create the issue manually:\n\n` +
+    `⚠️ Failed to create issue automatically. Please create it manually:\n\n` +
     `**Quick link** (may truncate long descriptions):\n${directUrl}\n\n` +
     `**Or copy this template to** ${issueUrl}:\n\n` +
-    `---\n**Title:** ${title}\n\n${body}\n---\n\n` +
-    `To enable automatic issue creation, set GITHUB_TOKEN environment variable.`
+    `---\n**Title:** ${title}\n\n${body}\n---`
   );
 }