Stock Analysis

from flying3615

An MCP server for stock analysis, offering tools for chip distribution, pattern analysis, trend reversal detection, and market scanning.

🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup

#git #finance

Stock Analysis MCP Server

This is a Model Context Protocol (MCP) server that provides stock analysis tools for Claude Desktop. The server integrates existing stock analysis features, including chip distribution analysis, pattern analysis, trend reversal detection, and market scanning capabilities.

Stock data query: Yahoo Finance
Company fundamental data query: Requires FMP API_KEY (https://site.financialmodelingprep.com/)

Features

Fully compatible with Claude Desktop's MCP interface
Provides various stock analysis tools:
- get-stock-analysis: Analyze specific stocks
- company-fundamental: Query company fundamental data
- start-bull-bear-scan: Scan the market for bullish and bearish signals (asynchronous task)
- start-strong-signal-scan: Scan the market for strong momentum stocks (asynchronous task)
- start-hot-stock-scan: Scan the market for top trending stocks (asynchronous task)
- get-task-status: Query the status and results of asynchronous tasks
- market-performance: Today's market performance, query stocks with biggest gains/losses and highest volume
Support for long-running asynchronous analysis tasks
Integration of comprehensive stock analysis functions
Generation of detailed trading plan reports

Development Testing

fastmcp provides two convenient ways to test:

Using command line mode:
```
npm run dev
```
Using web interface:
```
npm run inspect
```

These commands will start the respective test environments, allowing you to interact directly with the MCP server without requiring Claude Desktop.

Project Structure

claude-stock-mcp/
├── src/
│   ├── index.ts                # MCP server main file
│   ├── analysis/               # Stock analysis related code
│   │   ├── IntegratedAnalysis.ts
│   │   ├── IntegratedAnalysisTypes.ts
│   │   ├── chip/               # Chip distribution analysis
│   │   ├── patterns/           # Pattern analysis
│   │   └── trendReversal/      # Trend reversal analysis
│   ├── finance/                # Financial data related
│   │   ├── Conditions.ts
│   │   ├── Evaluator.ts
│   │   ├── FMPQuery.ts         # Financial Modeling Prep API query
│   │   ├── MarketQuery.ts      # Market data query
│   │   └── __tests__/          # Test files
│   ├── strategy/               # Strategy analysis
│   │   ├── BreakoutDetector.ts
│   │   ├── BullOrBearDetector.ts
│   │   └── StrategyAnalysisAgent.ts
│   ├── types.ts                # Type definitions
│   ├── config.ts               # Configuration file
│   └── util/                   # Utility functions
│       ├── TaskManager.ts      # Asynchronous task management
│       ├── Logger.ts           # Log handling
│       └── util.ts             # Common utility functions
├── dist/                       # Compiled output
├── logs/                       # Log file directory
├── package.json
└── tsconfig.json

Logging System

To avoid console output interfering with Claude Desktop, the project uses a custom logging system:

All console outputs are redirected to log files
Log files are located in the logs/ directory
Silent mode is enabled in the Claude Desktop environment, preventing all console output

Copy & paste — that's it

npm install

Before it works, you'll need: FMP_API_KEYAPLPVANTAGE_API_KEY

Installation and Configuration

Prerequisites

Node.js >= 16.0.0
npm >= 7.0.0
Claude Desktop

Local Installation and Running

Clone the repository:

git clone https://github.com/yourusername/claude-stock-mcp.git
cd claude-stock-mcp

Install dependencies:
```
npm install
```
Test the server in development mode:
```
npm run dev
```
Or use MCP Inspector:
```
npm run inspect
```
Build the project:
```
npm run build
```
Start the server:
```
npm start
```

Configure Claude Desktop

Create or edit the Claude Desktop configuration file:

# macOS
open -a "TextEdit" ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the server configuration:

{
  "mcpServers": {
    "stock-analysis": {
    "command": "npx",
    "args": [
      "@gabriel3615/claude-stock-analysis-mcp@latest"
     ],
     "env": {
      "FMP_API_KEY": "KEY_HERE",
      "APLPVANTAGE_API_KEY": "KEY_HERE"
     }
    }
  }
}

Note: You must use absolute paths and replace "yourusername" with your actual username.

Save the configuration file and restart Claude Desktop.

Usage

Once the server is configured, you can access the stock analysis features in Claude Desktop using the following approaches:

Analyze Stocks

Example questions:

"Please analyze Apple's stock performance"
"I want to understand the trading signals for Tesla stock (TSLA)"
"Help me analyze entry points and stop-loss levels for NVDA"

Claude will use the get-stock-analysis tool to analyze specific stocks.

Using Asynchronous Market Scanning Features