alnair-mcp 0.1.0

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * Alnair MCP — visible grant path for Cursor / Claude tool UIs.
+ *
+ * Returns a one-line notice the chat will show:
+ *   [alnair] GitHub access granted
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { AlnairClient, displayPermission } from "alnair-sdk";
+const server = new McpServer({
+    name: "alnair",
+    version: "0.1.0",
+});
+function grantLine(permissions) {
+    const groups = [...new Set(permissions.map((p) => displayPermission(p).group))];
+    const who = groups.length === 1 ? groups[0] : "Access";
+    return `[alnair] ${who} access granted`;
+}
+server.tool("requestAccess", `REQUIRED before git commit, git push, deploy, or DB writes in this project.
+
+Call this first, then run the privileged command. The user will see the grant
+in this tool result — that is intentional.
+
+Map actions → permissions:
+- git commit → ["github.git.commit"]
+- git push → ["github.git.push"]
+- merge PR → ["github.pull_request.merge"]
+- deploy → ["vercel.deploy.preview"]
+- DB write → ["supabase.write"]
+
+task = real commit subject / mission. Only request what you need.`, {
+    task: z.string().describe("What you are about to do, e.g. the commit subject"),
+    permissions: z
+        .array(z.string())
+        .describe('e.g. ["github.git.push"] or ["github.git.commit"]'),
+    ttl: z.string().optional().describe('Lifetime, default "15m"'),
+    agent: z.string().optional(),
+}, async ({ task, permissions, ttl, agent }) => {
+    try {
+        const client = await AlnairClient.fromProject(agent ? { agent } : {});
+        await client.mint({
+            task,
+            permissions,
+            ttl: ttl ?? "15m",
+            agent,
+            notify: false, // tool result is the notice
+        });
+        return {
+            content: [{ type: "text", text: grantLine(permissions) }],
+        };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `[alnair] Could not grant access — ${reason}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Alias for older instructions / Claude CLAUDE.md still naming mintCapability
+server.tool("mintCapability", `Alias of requestAccess. Prefer requestAccess.
+
+REQUIRED before git commit/push/deploy/DB writes. Returns a one-line grant notice.`, {
+    task: z.string(),
+    permissions: z.array(z.string()),
+    ttl: z.string().optional(),
+    agent: z.string().optional(),
+}, async ({ task, permissions, ttl, agent }) => {
+    try {
+        const client = await AlnairClient.fromProject(agent ? { agent } : {});
+        await client.mint({
+            task,
+            permissions,
+            ttl: ttl ?? "15m",
+            agent,
+            notify: false,
+        });
+        return {
+            content: [{ type: "text", text: grantLine(permissions) }],
+        };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `[alnair] Could not grant access — ${reason}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "alnair-mcp",
+  "version": "0.1.0",
+  "description": "Alnair MCP server — requestAccess for Claude Code and Cursor",
+  "type": "module",
+  "bin": {
+    "alnair-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CamiloJac/seren.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": [
+    "alnair",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agents",
+    "permissions"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "alnair-sdk": "^0.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.8.6",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}