firecrawl-mcp 2.1.0 → 3.0.0

package/dist/server-v1.js

@@ -771,10 +771,10 @@ export function createV1Server() {
         const startTime = Date.now();
         try {
             const { name, arguments: args } = request.params;
-            const apiKey = process.env.CLOUD_SERVICE
+            const apiKey = process.env.CLOUD_SERVICE === 'true'
                 ? request.params._meta?.apiKey
                 : FIRECRAWL_API_KEY;
-            if (process.env.CLOUD_SERVICE && !apiKey) {
+            if (process.env.CLOUD_SERVICE === 'true' && !apiKey) {
                 throw new Error('No API key provided');
             }
             const client = new FirecrawlApp({
@@ -807,22 +807,26 @@ export function createV1Server() {
                         }
                         // Format content based on requested formats
                         const contentParts = [];
-                        if (options.formats?.includes('markdown') && response.markdown) {
+                        const requestedFormats = options.formats && options.formats.length > 0
+                            ? options.formats
+                            : ['markdown'];
+                        if (requestedFormats.includes('markdown') && response.markdown) {
                             contentParts.push(response.markdown);
                         }
-                        if (options.formats?.includes('html') && response.html) {
+                        if (requestedFormats.includes('html') && response.html) {
                             contentParts.push(response.html);
                         }
-                        if (options.formats?.includes('rawHtml') && response.rawHtml) {
+                        if (requestedFormats.includes('rawHtml') && response.rawHtml) {
                             contentParts.push(response.rawHtml);
                         }
-                        if (options.formats?.includes('links') && response.links) {
+                        if (requestedFormats.includes('links') && response.links) {
                             contentParts.push(response.links.join('\n'));
                         }
-                        if (options.formats?.includes('screenshot') && response.screenshot) {
+                        if (requestedFormats.includes('screenshot') &&
+                            response.screenshot) {
                             contentParts.push(response.screenshot);
                         }
-                        if (options.formats?.includes('extract') && response.extract) {
+                        if (requestedFormats.includes('extract') && response.extract) {
                             contentParts.push(JSON.stringify(response.extract, null, 2));
                         }
                         // If options.formats is empty, default to markdown

package/dist/versioned-server.js

@@ -14,8 +14,14 @@ export async function runVersionedSSECloudServer() {
             status: 'OK',
             versions: ['v1', 'v2'],
             endpoints: {
-                v1: '/:apiKey/sse',
-                v2: '/:apiKey/v2/sse'
+                v1: {
+                    sse: '/{apiKey}/sse',
+                    messages: '/{apiKey}/messages'
+                },
+                v2: {
+                    sse: '/{apiKey}/v2/sse',
+                    messages: '/{apiKey}/v2/messages'
+                }
             }
         });
     });
@@ -35,6 +41,10 @@ export async function runVersionedSSECloudServer() {
         });
         await v1Server.connect(transport);
     });
+    // V1 SSE HEAD for quick availability checks
+    app.head('/:apiKey/sse', (req, res) => {
+        res.status(200).end();
+    });
     // V2 SSE endpoint (new)
     app.get('/:apiKey/v2/sse', async (req, res) => {
         const apiKey = req.params.apiKey;
@@ -48,6 +58,10 @@ export async function runVersionedSSECloudServer() {
         });
         await v2Server.connect(transport);
     });
+    // V2 SSE HEAD for quick availability checks
+    app.head('/:apiKey/v2/sse', (req, res) => {
+        res.status(200).end();
+    });
     // V1 message endpoint (legacy)
     app.post('/:apiKey/messages', express.json(), async (req, res) => {
         const apiKey = req.params.apiKey;
@@ -65,9 +79,23 @@ export async function runVersionedSSECloudServer() {
             enrichedBody.params._meta.apiKey = apiKey;
         }
         console.log(`[V1] Message received for API key: ${apiKey}`);
-        const sessionId = req.query.sessionId;
-        const compositeKey = `${apiKey}-${sessionId}`;
-        const versionedTransport = transports[compositeKey];
+        // Prefer explicit sessionId from query, then common header names
+        const rawSessionId = req.query.sessionId ||
+            req.headers['mcp-session-id'] ||
+            req.headers['x-mcp-session-id'] ||
+            '';
+        let compositeKey = `${apiKey}-${rawSessionId}`;
+        let versionedTransport = transports[compositeKey];
+        // Fallback: if not found, and there is exactly one active V1 transport for this apiKey, use it
+        if (!versionedTransport) {
+            const candidates = Object.entries(transports).filter(([key, vt]) => vt.version === 'v1' && key.startsWith(`${apiKey}-`));
+            if (candidates.length === 1) {
+                const [fallbackKey, vt] = candidates[0];
+                console.warn(`[V1] sessionId not provided or not found. Falling back to single active transport: ${fallbackKey}`);
+                compositeKey = fallbackKey;
+                versionedTransport = vt;
+            }
+        }
         if (versionedTransport && versionedTransport.version === 'v1') {
             await versionedTransport.transport.handlePostMessage(req, res, enrichedBody);
         }
@@ -113,7 +141,7 @@ export async function runVersionedSSECloudServer() {
         }
     });
     // Catch-all for unsupported endpoints
-    app.use('*', (req, res) => {
+    app.use((req, res) => {
         res.status(404).json({
             error: 'Endpoint not found',
             supportedEndpoints: {
@@ -130,19 +158,26 @@ export async function runVersionedSSECloudServer() {
         });
     });
     const PORT = process.env.PORT || 3000;
-    app.listen(PORT, () => {
+    const server = app.listen(PORT, () => {
         console.log(`🚀 Versioned MCP SSE Server listening on http://localhost:${PORT}`);
         console.log('📋 Available endpoints:');
         console.log(`   Health: http://localhost:${PORT}/health`);
-        console.log(`   V1 SSE: http://localhost:${PORT}/:apiKey/sse`);
-        console.log(`   V1 Messages: http://localhost:${PORT}/:apiKey/messages`);
-        console.log(`   V2 SSE: http://localhost:${PORT}/:apiKey/v2/sse`);
-        console.log(`   V2 Messages: http://localhost:${PORT}/:apiKey/v2/messages`);
+        console.log(`   V1 SSE: http://localhost:${PORT}/{apiKey}/sse`);
+        console.log(`   V1 Messages: http://localhost:${PORT}/{apiKey}/messages`);
+        console.log(`   V2 SSE: http://localhost:${PORT}/{apiKey}/v2/sse`);
+        console.log(`   V2 Messages: http://localhost:${PORT}/{apiKey}/v2/messages`);
         console.log('');
         console.log('🔧 Versions:');
         console.log('   V1: Firecrawl JS 1.29.3 (legacy tools + deep research + llms.txt)');
         console.log('   V2: Firecrawl JS 3.1.0 (modern API + JSON extraction)');
     });
+    server.on('error', (error) => {
+        console.error('❌ Server error:', error);
+        if (error.code === 'EADDRINUSE') {
+            console.error(`❌ Port ${PORT} is already in use. Please use a different port.`);
+        }
+        process.exit(1);
+    });
     // Graceful shutdown
     process.on('SIGINT', () => {
         console.log('\n🛑 Shutting down server...');
@@ -162,3 +197,7 @@ export async function runVersionedSSECloudServer() {
         process.exit(0);
     });
 }
+// Start the server if this file is run directly
+// if (import.meta.url === `file://${process.argv[1]}`) {
+//   runVersionedSSECloudServer().catch(console.error);
+// }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-mcp",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "MCP server for Firecrawl web scraping integration. Supports both cloud and self-hosted instances. Features include web scraping, search, batch processing, structured data extraction, and LLM-powered content analysis.",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "test:endpoints": "node test-endpoints.js",
     "start": "node dist/index.js",
     "start:cloud": "CLOUD_SERVICE=true node dist/index.js",
+    "start:fastmcp": "node dist/fastmcp/server.js",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
     "format": "prettier --write .",
@@ -27,29 +28,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@mendable/firecrawl-js": "^3.0.3",
-    "@modelcontextprotocol/sdk": "^1.17.3",
-    "dotenv": "^16.4.7",
-    "express": "^5.1.0",
-    "firecrawl-js-current": "npm:@mendable/firecrawl-js@^3.1.0",
-    "firecrawl-js-legacy": "npm:@mendable/firecrawl-js@^1.29.3",
-    "shx": "^0.3.4",
+    "@mendable/firecrawl-js": "^4.3.4",
+    "dotenv": "^17.2.2",
+    "fastmcp": "^3.16.0",
     "typescript": "^5.9.2",
-    "ws": "^8.18.1"
-  },
-  "devDependencies": {
-    "@jest/globals": "^29.7.0",
-    "@types/express": "^5.0.1",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.10.5",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.56.0",
-    "eslint-config-prettier": "^9.1.0",
-    "jest": "^29.7.0",
-    "jest-mock-extended": "^4.0.0-beta1",
-    "prettier": "^3.1.1",
-    "ts-jest": "^29.1.1"
+    "zod": "^4.1.5"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -69,5 +52,8 @@
   "bugs": {
     "url": "https://github.com/firecrawl/firecrawl-mcp-server/issues"
   },
-  "homepage": "https://github.com/firecrawl/firecrawl-mcp-server#readme"
+  "homepage": "https://github.com/firecrawl/firecrawl-mcp-server#readme",
+  "devDependencies": {
+    "@types/node": "^24.3.1"
+  }
 }