@thenextgennexus/finance-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# Finance MCP Server
+
+Get stock data, screen stocks, track crypto prices, and monitor exchange rates — powered by [nexgendata](https://apify.com/nexgendata) on Apify.
+
+## Quick Start
+
+### Using npx (recommended)
+
+```bash
+npx @nexgendata/finance-mcp-server
+```
+
+### Install globally
+
+```bash
+npm install -g @nexgendata/finance-mcp-server
+```
+
+## Configure with Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+      "mcpServers": {
+            "finance-mcp-server": {
+                  "command": "npx",
+                  "args": [
+                        "-y",
+                        "@nexgendata/finance-mcp-server"
+                  ],
+                  "env": {
+                        "APIFY_TOKEN": "your-apify-token-optional"
+                  }
+            }
+      }
+}
+```
+
+## Configure with Cline
+
+Add the same configuration to your Cline MCP settings.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_stock_data` | Get stock price and financial data for a ticker |
+| `screen_stocks` | Screen stocks by financial criteria using Finviz |
+| `get_crypto_prices` | Get current cryptocurrency prices |
+| `get_exchange_rates` | Get currency exchange rates |
+| `track_crypto_portfolio` | Track a cryptocurrency portfolio |
+
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `APIFY_TOKEN` | No | Your Apify API token for authenticated access. Without it, the server uses the public endpoint (rate-limited). |
+
+## How It Works
+
+This MCP server acts as a local stdio bridge to the [nexgendata Apify MCP endpoint](https://nexgendata--finance-mcp-server.apify.actor/mcp). When you call a tool, it forwards the request to Apify and returns the results.
+
+## Links
+
+- [Apify Store](https://apify.com/nexgendata/finance-mcp-server)
+- [GitHub Repository](https://github.com/TheNextGenNexus/ai-analytics-mcp-servers)
+- [nexgendata Blog](https://thenextgennexus.com)
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const APIFY_ENDPOINT = "https://nexgendata--finance-mcp-server.apify.actor/mcp";
+const APIFY_TOKEN = process.env.APIFY_TOKEN || "";
+async function callApifyTool(toolName, args) {
+    const url = new URL(APIFY_ENDPOINT);
+    if (APIFY_TOKEN) {
+        url.searchParams.set("token", APIFY_TOKEN);
+    }
+    const body = {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+            name: toolName,
+            arguments: args
+        }
+    };
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Apify API error (${response.status}): ${errorText}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+        throw new Error(`Tool error: ${JSON.stringify(data.error)}`);
+    }
+    // Extract text content from MCP response
+    const result = data.result;
+    if (result?.content && Array.isArray(result.content)) {
+        return result.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("\n");
+    }
+    return JSON.stringify(data.result, null, 2);
+}
+const server = new McpServer({
+    name: "finance-mcp-server",
+    version: "1.0.0"
+});
+server.registerTool("get_stock_data", {
+    title: "Get Stock Data",
+    description: "Get stock price and financial data",
+    inputSchema: {
+        ticker: z.string().describe('Stock ticker symbol e.g. AAPL')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("get_stock_data", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("screen_stocks", {
+    title: "Screen Stocks",
+    description: "Screen stocks by criteria",
+    inputSchema: {
+        filters: z.string().describe('Screening criteria'),
+        maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("screen_stocks", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("get_crypto_prices", {
+    title: "Get Crypto Prices",
+    description: "Get cryptocurrency prices",
+    inputSchema: {
+        coinIds: z.array(z.string()).describe('Coin IDs e.g. bitcoin, ethereum'),
+        maxItems: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("get_crypto_prices", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("get_exchange_rates", {
+    title: "Get Exchange Rates",
+    description: "Get currency exchange rates",
+    inputSchema: {
+        baseCurrency: z.string().default('USD').describe('Base currency code'),
+        maxItems: z.number().default(10).describe('Maximum rates')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("get_exchange_rates", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("track_crypto_portfolio", {
+    title: "Track Crypto Portfolio",
+    description: "Track crypto portfolio",
+    inputSchema: {
+        coinIds: z.array(z.string()).describe('Coin IDs to track'),
+        maxResults: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("track_crypto_portfolio", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Finance MCP Server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@thenextgennexus/finance-mcp-server",
+  "version": "1.0.0",
+  "description": "Get stock data, screen stocks, track crypto prices, and monitor exchange rates",
+  "type": "module",
+  "bin": {
+    "finance-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "tsx": "^4.7.0",
+    "@types/node": "^20.11.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "apify",
+    "nexgendata"
+  ],
+  "author": "nexgendata",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TheNextGenNexus/ai-analytics-mcp-servers"
+  },
+  "mcpName": "io.github.thenextgennexus/finance-mcp-server"
+}

package/smithery.yaml

@@ -0,0 +1,13 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - apifyToken
+    properties:
+      apifyToken:
+        type: string
+        description: Your Apify API token. Get one free at https://apify.com
+  commandFunction:
+    |-
+    (config) => ({{ command: 'npx', args: ['tsx', 'src/index.ts'], env: {{ APIFY_TOKEN: config.apifyToken }} }})

package/src/index.ts

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const APIFY_ENDPOINT = "https://nexgendata--finance-mcp-server.apify.actor/mcp";
+const APIFY_TOKEN = process.env.APIFY_TOKEN || "";
+
+async function callApifyTool(toolName: string, args: Record<string, unknown>): Promise<string> {
+  const url = new URL(APIFY_ENDPOINT);
+  if (APIFY_TOKEN) {
+    url.searchParams.set("token", APIFY_TOKEN);
+  }
+
+  const body = {
+    jsonrpc: "2.0",
+    id: 1,
+    method: "tools/call",
+    params: {
+      name: toolName,
+      arguments: args
+    }
+  };
+
+  const response = await fetch(url.toString(), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Apify API error (${response.status}): ${errorText}`);
+  }
+
+  const data = await response.json();
+
+  if (data.error) {
+    throw new Error(`Tool error: ${JSON.stringify(data.error)}`);
+  }
+
+  // Extract text content from MCP response
+  const result = data.result;
+  if (result?.content && Array.isArray(result.content)) {
+    return result.content
+      .filter((c: { type: string }) => c.type === "text")
+      .map((c: { text: string }) => c.text)
+      .join("\n");
+  }
+
+  return JSON.stringify(data.result, null, 2);
+}
+
+const server = new McpServer({
+  name: "finance-mcp-server",
+  version: "1.0.0"
+});
+
+server.registerTool(
+  "get_stock_data",
+  {
+    title: "Get Stock Data",
+    description: "Get stock price and financial data",
+    inputSchema: {
+      ticker: z.string().describe('Stock ticker symbol e.g. AAPL')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("get_stock_data", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "screen_stocks",
+  {
+    title: "Screen Stocks",
+    description: "Screen stocks by criteria",
+    inputSchema: {
+      filters: z.string().describe('Screening criteria'),
+      maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("screen_stocks", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "get_crypto_prices",
+  {
+    title: "Get Crypto Prices",
+    description: "Get cryptocurrency prices",
+    inputSchema: {
+      coinIds: z.array(z.string()).describe('Coin IDs e.g. bitcoin, ethereum'),
+      maxItems: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("get_crypto_prices", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "get_exchange_rates",
+  {
+    title: "Get Exchange Rates",
+    description: "Get currency exchange rates",
+    inputSchema: {
+      baseCurrency: z.string().default('USD').describe('Base currency code'),
+      maxItems: z.number().default(10).describe('Maximum rates')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("get_exchange_rates", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "track_crypto_portfolio",
+  {
+    title: "Track Crypto Portfolio",
+    description: "Track crypto portfolio",
+    inputSchema: {
+      coinIds: z.array(z.string()).describe('Coin IDs to track'),
+      maxResults: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("track_crypto_portfolio", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Finance MCP Server running on stdio");
+}
+
+main().catch(console.error);

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}