Local Stock Analyst MCP (stdio)

Local TypeScript MCP server for Claude Desktop that exposes stock-analysis tools using:

• Finnhub as the primary provider

• Alpha Vantage as fallback

• local indicator calculation fallback for RSI and MACD

The server supports:

• stdio mode for local Claude Desktop integration (default)

• HTTP mode for cloud hosting (for example, Render)

Tools

• get_stock_price

• get_quote

• get_company_profile

• get_candles

• get_stock_news

• get_rsi

• get_macd

• get_key_financials

Each tool validates input with zod, formats output consistently, and includes an informational disclaimer.

Requirements

• Node.js 18+

• npm

• API key for at least one provider:

  • Finnhub: FINNHUB_API_KEY

  • Alpha Vantage: ALPHAVANTAGE_API_KEY

Setup

1. Install dependencies:

2. Create env file from template:

3. Add your API keys to .env.

Build and Run

Build:

Start locally (stdio MCP mode):

Start in HTTP mode (Render-style):

HTTP endpoints:

• MCP endpoint: /mcp

• health check: /healthz

Claude Desktop (Windows) Configuration

Open your Claude Desktop config file:

• %APPDATA%\Claude\claude_desktop_config.json

Add/update:

Notes:

• Use absolute paths in args.

• Forward slashes are safe on Windows JSON paths.

• Restart Claude Desktop after saving config.

Deploy on Render

Use a Web Service deployment.

1. Push this project to GitHub.

2. In Render, create a new Web Service from your repo.

3. Configure:

   • Build Command: npm install && npm run build

   • Start Command: npm start

4. Add environment variables:

   • MCP_TRANSPORT=http

   • FINNHUB_API_KEY=... (optional but recommended)

   • ALPHAVANTAGE_API_KEY=... (optional fallback)

   • PORT is auto-provided by Render.

5. Deploy.

After deploy, verify:

• https://<your-service>.onrender.com/healthz returns {"status":"ok"}

• MCP server endpoint is https://<your-service>.onrender.com/mcp

Quick Test Prompts in Claude

• "Call get_stock_price for MSFT."

• "Call get_candles for MSFT, interval D, from 1704067200, to 1735689600, limit 5."

• "Call get_rsi for MSFT, interval D, from 1704067200, to 1735689600."

Troubleshooting

• No tools visible in Claude

  • Check JSON validity of claude_desktop_config.json.

  • Confirm build/index.js exists (npm run build).

  • Fully restart Claude Desktop.

• Auth errors

  • Verify API keys in config env or local .env.

• Rate-limit errors

  • Retry later, reduce call frequency, or use higher-tier keys.

  • The server automatically attempts Alpha Vantage fallback after Finnhub failures.

Logs

• Claude Desktop logs are usually in %APPDATA%\Claude\logs.

• Server startup/errors are written to stderr by the MCP process.