Figma MCP Server

/** * Figma MCP Server Actor - Main Entry Point * Long-running HTTP server implementing Model Context Protocol */ import { Actor } from "apify"; import express from "express"; import { FigmaAuth } from "./figma/auth.js"; import { FigmaClient } from "./figma/client.js"; import { createMCPHandler } from "./mcp/handlers.js"; import { MCPProtocol } from "./mcp/protocol.js"; import { MCPServer } from "./mcp/server.js"; import { registerFigmaPrompts } from "./prompts/figma-prompts.js"; import { registerFigmaResources } from "./resources/figma-resources.js"; import { registerAssetExportTools } from "./tools/asset-export.js"; import { registerCommentTools } from "./tools/comments.js"; import { registerComponentExtractionTools } from "./tools/component-extraction.js"; import { registerDesignModificationTools } from "./tools/design-modification.js"; // Import tools, resources, and prompts import { registerFileAnalysisTools } from "./tools/file-analysis.js"; await Actor.init(); // Get input configuration const input = (await Actor.getInput()) ?? {}; const { figmaAccessToken, port = 8080, oauthClientId, oauthClientSecret, enableCaching = true, } = input; // Get web server port from Apify configuration (takes precedence) const webServerPort = Actor.configuration?.web_server_port || port; // Initialize Figma authentication and client const auth = new FigmaAuth({ figmaAccessToken, oauthClientId, oauthClientSecret, }); if (!auth.isAuthenticated()) { throw new Error( "Figma authentication required. Please provide figmaAccessToken in input.", ); } const figmaClient = new FigmaClient(auth); figmaClient.setCacheEnabled(enableCaching); // Initialize MCP protocol and server const protocol = new MCPProtocol(); const mcpServer = new MCPServer(protocol); // Register all tools registerFileAnalysisTools(protocol, figmaClient); registerComponentExtractionTools(protocol, figmaClient); registerAssetExportTools(protocol, figmaClient); registerCommentTools(protocol, figmaClient); registerDesignModificationTools(protocol, figmaClient); // Register all resources registerFigmaResources(protocol, figmaClient); // Register all prompts registerFigmaPrompts(protocol, figmaClient); // Create Express app const app = express(); // Middleware app.use(express.json()); app.use(express.urlencoded({ extended: true })); // Health check endpoint app.get("/health", (req, res) => { res.json({ status: "ok", service: "figma-mcp-server", version: "0.0.1", authenticated: auth.isAuthenticated(), timestamp: new Date().toISOString(), }); }); // Root endpoint info app.get("/", (req, res) => { res.json({ service: "Figma MCP Server", version: "0.0.1", endpoints: { mcp: "/mcp", health: "/health", }, protocol: "Model Context Protocol (MCP)", transport: "JSON-RPC 2.0 over HTTP", }); }); // MCP JSON-RPC endpoint app.post("/mcp", createMCPHandler(mcpServer)); // Error handling middleware app.use((err, req, res, _next) => { // Log error (Apify captures console output) // eslint-disable-next-line no-console console.error("Express error:", err); res.status(500).json({ error: "Internal server error", message: err.message, }); }); // Start HTTP server const server = app.listen(webServerPort, "0.0.0.0", () => { // eslint-disable-next-line no-console console.log(`Figma MCP Server listening on port ${webServerPort}`); // eslint-disable-next-line no-console console.log(`Health check: http://localhost:${webServerPort}/health`); // eslint-disable-next-line no-console console.log(`MCP endpoint: http://localhost:${webServerPort}/mcp`); // eslint-disable-next-line no-console console.log("Server is running in long-running mode..."); }); // Graceful shutdown process.on("SIGTERM", () => { // eslint-disable-next-line no-console console.log("SIGTERM received, shutting down gracefully..."); server.close(() => { // eslint-disable-next-line no-console console.log("HTTP server closed"); Actor.exit(); }); }); process.on("SIGINT", () => { // eslint-disable-next-line no-console console.log("SIGINT received, shutting down gracefully..."); server.close(() => { // eslint-disable-next-line no-console console.log("HTTP server closed"); Actor.exit(); }); }); // Keep the process alive (long-running mode) // The server will continue running until explicitly stopped