MCP股票扫描

Finnhub — News, Earnings & Macro (requires `FINNHUB_API_KEY`)

Alpha Vantage — Fundamentals & History (requires `ALPHA_VANTAGE_API_KEY`)

FRED — US Economic Data (requires `FRED_API_KEY`)

Step 2 — Install the trading skills

Run this command in your terminal:

npx -p stock-scanner-mcp stock-scanner-install-skills

This installs 19 slash commands (like /morning-briefing, /analyze-stock AAPL, /setup-market-workspace) into ~/.claude/skills/ so they're available in every Claude Code session. See Trading Skills for the full list.

Quick Start

Three steps to get the full experience: server config, trading skills, and workspace setup.

Step 1 — Add the server to your MCP config

Copy this complete config block into your config file:

• Claude Code: ~/.claude.json (global) or .mcp.json (project-local)
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "stock-scanner": {
      "command": "npx",
      "args": ["-y", "stock-scanner-mcp", "--enable-workspace"],
      "env": {
        "FINNHUB_API_KEY": "your-key-here",
        "ALPHA_VANTAGE_API_KEY": "your-key-here",
        "FRED_API_KEY": "your-key-here"
      }
    }
  }
}

This gives you 46 tools immediately with no API keys. API keys are optional and free — they unlock 18 additional tools for real-time quotes, news, earnings, and economic data. See API Keys below for where to get them.

Minimal config — if you don't want workspace or API keys, use this instead:

> {
>   "mcpServers": {
>     "stock-scanner": {
>       "command": "npx",
>       "args": ["-y", "stock-scanner-mcp"]
>     }
>   }
> }
> 

This gives you 39 stateless tools with no local data storage.

Restart Claude Desktop after saving. Claude Code picks up the config automatically.

Configuration reference

Data is stored locally in workspace.json — no cloud sync, no external calls. If you omit --enable-workspace, the server stays fully stateless and writes no local data.

For the full list of workspace tools, see the tool reference below.

Options — Chains, Greeks & Unusual Activity (no API key)

Options CBOE — Put/Call Sentiment (no API key)

Workspace — Personalized Context (optional, no API key)

Enabled only when you start the server with --enable-workspace.

Configuration

CLI Options

npx -y stock-scanner-mcp --modules tradingview,sec-edgar    # Enable specific modules only
npx -y stock-scanner-mcp --default-exchange NYSE             # Set default exchange
npx -y stock-scanner-mcp --enable-workspace                  # Turn on local workspace tools
npx -y stock-scanner-mcp --enable-workspace --data-dir /tmp/market-workspace  # Custom data directory
npx -y stock-scanner-mcp --help                              # Show all options

API Keys (optional)

All three keys are free — no credit card required:

Add them to the env block in your MCP config (see Quick Start).

Full Tool Reference (64 tools)

TradingView — Stock Scanning (no API key)

TradingView — Crypto (no API key)

SEC EDGAR — Filings & Ownership (no API key)

CoinGecko — Crypto Intelligence (no API key)

Sentiment — Fear & Greed (no API key)

Frankfurter — Forex Rates (no API key)

Reddit — Trending Tickers & Sentiment (no API key)

Modules

Modules auto-enable when their API key is set. No-key modules are always enabled, except workspace, which requires --enable-workspace.

For a complete list of every tool with descriptions, see the Full Tool Reference below.