acuity-mcp-server 1.0.0

package/dist/server/http-server.js

@@ -0,0 +1,167 @@
+/**
+ * HTTP Server for Acuity MCP
+ * Implements Streamable HTTP transport for remote clients (Copilot, Claude, etc.)
+ */
+import express from 'express';
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { validateHttpAuth } from '../auth/http-auth.js';
+import { createMcpServer } from './mcp-core.js';
+// Store active sessions
+const sessions = new Map();
+// Session timeout (30 minutes)
+const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+/**
+ * Clean up expired sessions periodically
+ */
+function startSessionCleanup() {
+    setInterval(() => {
+        const now = Date.now();
+        for (const [sessionId, session] of sessions.entries()) {
+            if (now - session.createdAt.getTime() > SESSION_TIMEOUT_MS) {
+                console.log(`[HTTP] Cleaning up expired session: ${sessionId}`);
+                session.transport.close();
+                sessions.delete(sessionId);
+            }
+        }
+    }, 60000); // Check every minute
+}
+/**
+ * Create and configure Express app for MCP HTTP server
+ */
+export function createHttpServer() {
+    const app = express();
+    // Parse JSON bodies
+    app.use(express.json());
+    // Health check endpoint (no auth required)
+    app.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            service: 'acuity-mcp-server',
+            activeSessions: sessions.size
+        });
+    });
+    // OpenAPI schema endpoint (no auth required)
+    app.get('/openapi.yaml', (_req, res) => {
+        res.sendFile('openapi.yaml', { root: process.cwd() });
+    });
+    // MCP endpoint - POST (handle requests)
+    app.post('/mcp', validateHttpAuth, async (req, res) => {
+        const authReq = req;
+        const sessionId = req.headers['mcp-session-id'];
+        try {
+            let session = sessionId ? sessions.get(sessionId) : undefined;
+            if (session) {
+                // Reuse existing session
+                await session.transport.handleRequest(req, res, req.body);
+            }
+            else if (!sessionId && isInitializeRequest(req.body)) {
+                // Create new session
+                const newSessionId = randomUUID();
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => newSessionId,
+                    onsessioninitialized: (id) => {
+                        console.log(`[HTTP] Session initialized: ${id} for user: ${authReq.userEmail}`);
+                    }
+                });
+                // Create MCP server instance for this session
+                const server = createMcpServer(authReq.userEmail, authReq.userToken);
+                // Store session
+                sessions.set(newSessionId, {
+                    transport,
+                    server,
+                    email: authReq.userEmail,
+                    createdAt: new Date()
+                });
+                // Handle transport close
+                transport.onclose = () => {
+                    console.log(`[HTTP] Transport closed for session: ${newSessionId}`);
+                    sessions.delete(newSessionId);
+                };
+                // Connect server to transport
+                await server.connect(transport);
+                // Handle the initialize request
+                await transport.handleRequest(req, res, req.body);
+            }
+            else {
+                // Invalid request - no session and not an initialize request
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32000,
+                        message: 'Invalid session. Send initialize request first or include valid mcp-session-id header.'
+                    },
+                    id: null
+                });
+            }
+        }
+        catch (error) {
+            console.error('[HTTP] Error handling POST /mcp:', error);
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error'
+                },
+                id: null
+            });
+        }
+    });
+    // MCP endpoint - GET (SSE stream for server-to-client messages)
+    app.get('/mcp', validateHttpAuth, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        const session = sessions.get(sessionId);
+        if (!session) {
+            res.status(400).json({
+                jsonrpc: '2.0',
+                error: { code: -32000, message: 'Invalid or missing session' },
+                id: null
+            });
+            return;
+        }
+        await session.transport.handleRequest(req, res);
+    });
+    // MCP endpoint - DELETE (close session)
+    app.delete('/mcp', validateHttpAuth, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        const session = sessions.get(sessionId);
+        if (session) {
+            await session.transport.handleRequest(req, res);
+            sessions.delete(sessionId);
+            console.log(`[HTTP] Session deleted: ${sessionId}`);
+        }
+        else {
+            res.status(400).json({
+                jsonrpc: '2.0',
+                error: { code: -32000, message: 'Invalid or missing session' },
+                id: null
+            });
+        }
+    });
+    // Error handling middleware
+    app.use((err, _req, res, _next) => {
+        console.error('[HTTP] Unhandled error:', err);
+        res.status(500).json({
+            jsonrpc: '2.0',
+            error: { code: -32603, message: 'Internal server error' },
+            id: null
+        });
+    });
+    // Start session cleanup
+    startSessionCleanup();
+    return app;
+}
+/**
+ * Start HTTP server on specified port
+ */
+export async function startHttpServer(port) {
+    const app = createHttpServer();
+    app.listen(port, () => {
+        console.log(`[HTTP] Acuity MCP Server listening on port ${port}`);
+        console.log(`[HTTP] MCP endpoint: http://localhost:${port}/mcp`);
+        console.log(`[HTTP] Health check: http://localhost:${port}/health`);
+        console.log(`[HTTP] OpenAPI schema: http://localhost:${port}/openapi.yaml`);
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/server/http-server.js.map

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

package/dist/server/mcp-core.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Server Core
+ * Shared MCP server logic used by both stdio and HTTP transports
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Create MCP server instance with all tools configured
+ * For HTTP mode: email and token are provided from HTTP auth
+ * For stdio mode: email and token are retrieved from keychain/env
+ */
+export declare function createMcpServer(userEmail: string, userToken: string): Server;
+//# sourceMappingURL=mcp-core.d.ts.map

package/dist/server/mcp-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-core.d.ts","sourceRoot":"","sources":["../../src/server/mcp-core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAoBnE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CA2OR"}

package/dist/server/mcp-core.js

@@ -0,0 +1,200 @@
+/**
+ * MCP Server Core
+ * Shared MCP server logic used by both stdio and HTTP transports
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { HasuraClient } from '../clients/hasura-client.js';
+import { acuityInit, acuityInitTool } from '../tools/acuity-init.js';
+import { listProjects, listProjectsTool } from '../tools/list-projects.js';
+import { getProject, getProjectTool } from '../tools/get-project.js';
+import { getStatusReports, getStatusReportsTool } from '../tools/get-status-reports.js';
+import { listRisks, listRisksTool } from '../tools/list-risks.js';
+import { getRisk, getRiskTool } from '../tools/get-risk.js';
+import { listIssues, listIssuesTool } from '../tools/list-issues.js';
+import { getIssue, getIssueTool } from '../tools/get-issue.js';
+import { listLessonsLearned, listLessonsLearnedTool } from '../tools/list-lessons-learned.js';
+import { getLessonLearned, getLessonLearnedTool } from '../tools/get-lesson-learned.js';
+import { getLookupValues, getLookupValuesTool } from '../tools/get-lookup-values.js';
+import { searchProjects, searchProjectsTool } from '../tools/search-projects.js';
+import { getDashboardSummary, getDashboardSummaryTool } from '../tools/get-dashboard-summary.js';
+/**
+ * Create MCP server instance with all tools configured
+ * For HTTP mode: email and token are provided from HTTP auth
+ * For stdio mode: email and token are retrieved from keychain/env
+ */
+export function createMcpServer(userEmail, userToken) {
+    // Create Hasura client for this user
+    const hasuraClient = HasuraClient.forUser(userEmail, userToken);
+    // Session state for this server instance
+    let sessionInitData = null;
+    // Create server instance
+    const server = new Server({
+        name: 'acuity-mcp-server',
+        version: '1.0.0'
+    }, {
+        capabilities: {
+            tools: {}
+        }
+    });
+    /**
+     * List available tools
+     * Note: For HTTP mode, we don't expose auth tools (acuity_login, acuity_logout, acuity_auth_status)
+     * because authentication is handled via HTTP headers
+     */
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                acuityInitTool,
+                listProjectsTool,
+                getProjectTool,
+                searchProjectsTool,
+                getStatusReportsTool,
+                listRisksTool,
+                getRiskTool,
+                listIssuesTool,
+                getIssueTool,
+                listLessonsLearnedTool,
+                getLessonLearnedTool,
+                getLookupValuesTool,
+                getDashboardSummaryTool
+            ]
+        };
+    });
+    /**
+     * Handle tool execution
+     */
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name } = request.params;
+        try {
+            // Helper: auto-initialize if needed
+            async function ensureInitialized() {
+                if (!sessionInitData) {
+                    sessionInitData = await acuityInit(hasuraClient);
+                }
+                return sessionInitData;
+            }
+            switch (name) {
+                case 'acuity_init': {
+                    // Always refresh on explicit call
+                    sessionInitData = await acuityInit(hasuraClient);
+                    const d = sessionInitData;
+                    const summary = `✅ Acuity initialized
+
+Company: ${d.company}
+Currency: ${d.currency_code} (${d.currency_locale})
+
+Data available:
+• Projects: ${d.entities.projects.count} | Proposals: ${d.entities.proposals.count}
+• Risks: ${d.entities.project_risks.count} (project) + ${d.entities.proposal_risks.count} (proposal)
+• Issues: ${d.entities.project_issues.count} (project) + ${d.entities.proposal_issues.count} (proposal)
+• Lessons: ${d.entities.lessons_learned.count}
+• Status Reports: ${d.entities.status_reports.count}
+
+Lookups: ${d.lookup_tables.departments} departments, ${d.lookup_tables.categories} categories, ${d.lookup_tables.lifecycles} lifecycles`;
+                    return {
+                        content: [{ type: 'text', text: summary }]
+                    };
+                }
+                case 'list_projects': {
+                    const initData = await ensureInitialized();
+                    const listResult = await listProjects(request.params.arguments, hasuraClient);
+                    const response = sessionInitData === initData && !request.params.arguments
+                        ? { _context: initData, ...listResult }
+                        : listResult;
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(response, null, 2) }]
+                    };
+                }
+                case 'get_project': {
+                    await ensureInitialized();
+                    const projectResult = await getProject(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(projectResult, null, 2) }]
+                    };
+                }
+                case 'search_projects': {
+                    await ensureInitialized();
+                    const searchResult = await searchProjects(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(searchResult, null, 2) }]
+                    };
+                }
+                case 'get_status_reports': {
+                    await ensureInitialized();
+                    const statusReportsText = await getStatusReports(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: statusReportsText }]
+                    };
+                }
+                case 'list_risks': {
+                    await ensureInitialized();
+                    const risksResult = await listRisks(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(risksResult, null, 2) }]
+                    };
+                }
+                case 'get_risk': {
+                    await ensureInitialized();
+                    const riskResult = await getRisk(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(riskResult, null, 2) }]
+                    };
+                }
+                case 'list_issues': {
+                    await ensureInitialized();
+                    const issuesResult = await listIssues(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(issuesResult, null, 2) }]
+                    };
+                }
+                case 'get_issue': {
+                    await ensureInitialized();
+                    const issueResult = await getIssue(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(issueResult, null, 2) }]
+                    };
+                }
+                case 'list_lessons_learned': {
+                    await ensureInitialized();
+                    const lessonsResult = await listLessonsLearned(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(lessonsResult, null, 2) }]
+                    };
+                }
+                case 'get_lesson_learned': {
+                    await ensureInitialized();
+                    const lessonResult = await getLessonLearned(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(lessonResult, null, 2) }]
+                    };
+                }
+                case 'get_lookup_values': {
+                    await ensureInitialized();
+                    const lookupResult = await getLookupValues(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(lookupResult, null, 2) }]
+                    };
+                }
+                case 'get_dashboard_summary': {
+                    await ensureInitialized();
+                    const dashboardResult = await getDashboardSummary(request.params.arguments, hasuraClient);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(dashboardResult, null, 2) }]
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+                isError: true
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=mcp-core.js.map

package/dist/server/mcp-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-core.js","sourceRoot":"","sources":["../../src/server/mcp-core.ts"],"names":[],"mappings":"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"}

package/dist/tools/acuity-init.d.ts

@@ -0,0 +1,84 @@
+/**
+ * MCP Tool: acuity_init
+ * Initializes LLM context with minimal schema information
+ *
+ * Returns:
+ * - Company name
+ * - Entity counts (projects, risks, issues, lessons_learned, status_reports)
+ * - All enum values for filtering
+ * - Lookup table counts
+ * - Available tools
+ *
+ * This tool should be called first to give LLM understanding of available data.
+ * Target size: ~700-800 tokens
+ */
+import type { HasuraClient } from '../clients/hasura-client.js';
+export interface AcuityInitResult {
+    company: string;
+    currency_code: string;
+    currency_locale: string;
+    entities: {
+        projects: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+            has_counts: string[];
+            related: string[];
+        };
+        proposals: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+            related: string[];
+        };
+        project_risks: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+        proposal_risks: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+        project_issues: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+        proposal_issues: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+        lessons_learned: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+        status_reports: {
+            count: number;
+            description: string;
+            filterable_by: string[];
+        };
+    };
+    enums: Record<string, string[] | string>;
+    lookup_tables: Record<string, number>;
+    available_tools: string[];
+}
+/**
+ * Acuity init handler
+ */
+export declare function acuityInit(hasuraClient: HasuraClient): Promise<AcuityInitResult>;
+/**
+ * MCP tool definition for acuity_init
+ */
+export declare const acuityInitTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+    };
+};
+//# sourceMappingURL=acuity-init.d.ts.map

package/dist/tools/acuity-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acuity-init.d.ts","sourceRoot":"","sources":["../../src/tools/acuity-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IAExB,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;YACxB,UAAU,EAAE,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;QACF,SAAS,EAAE;YACT,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;QACF,aAAa,EAAE;YACb,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,eAAe,EAAE;YACf,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,eAAe,EAAE;YACf,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC;KACH,CAAC;IAEF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;IAEzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA8FD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAoI3B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;CAwB1B,CAAC"}