@finedata/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# @finedata/mcp-server
+
+MCP Server for [FineData](https://finedata.ai) web scraping API.
+
+This is a Node.js wrapper that launches the Python MCP server.
+
+## Quick Start
+
+```bash
+# Set your API key and run
+FINEDATA_API_KEY=fd_xxx npx @finedata/mcp-server
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "finedata": {
+      "command": "npx",
+      "args": ["-y", "@finedata/mcp-server"],
+      "env": {
+        "FINEDATA_API_KEY": "fd_your_api_key"
+      }
+    }
+  }
+}
+```
+
+### Cursor IDE
+
+Add to MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "finedata": {
+      "command": "npx",
+      "args": ["-y", "@finedata/mcp-server"],
+      "env": {
+        "FINEDATA_API_KEY": "fd_your_api_key"
+      }
+    }
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18+
+- Python 3.10+ OR [uv](https://github.com/astral-sh/uv) (recommended)
+
+## Recommended: Using uvx
+
+For better performance, install [uv](https://github.com/astral-sh/uv) and use uvx directly:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Then configure:
+
+```json
+{
+  "mcpServers": {
+    "finedata": {
+      "command": "uvx",
+      "args": ["finedata-mcp"],
+      "env": {
+        "FINEDATA_API_KEY": "fd_your_api_key"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+- **Antibot Bypass** - Cloudflare, DataDome, PerimeterX
+- **JavaScript Rendering** - Playwright for SPAs
+- **Captcha Solving** - reCAPTCHA, hCaptcha, Turnstile
+- **Proxy Rotation** - 87K+ datacenter + residential
+
+## Get Your API Key
+
+Sign up at [finedata.ai](https://finedata.ai) to get your API key and free trial tokens.
+
+## Documentation
+
+See the full documentation at https://docs.finedata.ai
+
+## Issues
+
+https://github.com/quality-network/finedata-mcp/issues

package/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/**
+ * FineData MCP Server Launcher
+ * 
+ * This script launches the Python MCP server using uvx (uv tool).
+ * uvx automatically handles Python environment and dependencies.
+ * 
+ * Usage:
+ *   npx @finedata/mcp-server
+ * 
+ * Environment variables:
+ *   FINEDATA_API_KEY - Your FineData API key (required)
+ *   FINEDATA_API_URL - API URL (default: https://api.finedata.ai)
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+// Check if API key is set
+if (!process.env.FINEDATA_API_KEY) {
+  console.error('Error: FINEDATA_API_KEY environment variable is required.');
+  console.error('Get your API key at https://finedata.ai');
+  process.exit(1);
+}
+
+// Try uvx first (recommended), fallback to python -m
+function tryUvx() {
+  const uvx = spawn('uvx', ['finedata-mcp'], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  uvx.on('error', (err) => {
+    if (err.code === 'ENOENT') {
+      // uvx not found, try python
+      tryPython();
+    } else {
+      console.error('Error starting server:', err.message);
+      process.exit(1);
+    }
+  });
+
+  uvx.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}
+
+function tryPython() {
+  // Try python3 first, then python
+  const pythonCommands = ['python3', 'python'];
+  
+  function tryNextPython(index) {
+    if (index >= pythonCommands.length) {
+      console.error('Error: Python not found. Please install Python 3.10+ or uv.');
+      console.error('Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh');
+      process.exit(1);
+    }
+
+    const cmd = pythonCommands[index];
+    const python = spawn(cmd, ['-m', 'finedata_mcp'], {
+      stdio: 'inherit',
+      env: process.env,
+    });
+
+    python.on('error', (err) => {
+      if (err.code === 'ENOENT') {
+        tryNextPython(index + 1);
+      } else {
+        console.error('Error starting server:', err.message);
+        process.exit(1);
+      }
+    });
+
+    python.on('exit', (code) => {
+      if (code === null) {
+        // Process was killed, try next
+        tryNextPython(index + 1);
+      } else {
+        process.exit(code);
+      }
+    });
+  }
+
+  tryNextPython(0);
+}
+
+// Start with uvx
+tryUvx();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@finedata/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP Server for FineData web scraping API - enables AI agents to scrape any website with antibot bypass",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "finedata",
+    "web-scraping",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "antibot",
+    "captcha-solving"
+  ],
+  "author": "FineData <support@finedata.ai>",
+  "license": "MIT",
+  "homepage": "https://finedata.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quality-network/finedata-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/quality-network/finedata-mcp/issues"
+  },
+  "bin": {
+    "finedata-mcp": "./index.js"
+  },
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}