Stock Market Server

🚀 Stock Market MCP Server

A TypeScript-based MCP server for retrieving stock market data. This server provides real-time stock market information and corporate financial data through the Alpha Vantage API.

✨ Features

Tools

• get_ticker_price - Get real-time stock price

  • Requires the stock symbol as a parameter
  • Returns the latest stock price and timestamp

• get_market_report - Get the US market report

  • Provides an overview of the overall market situation

• get_financial_statement - Get corporate financial statements

  • Supports three statement types: income statement (income), balance sheet (balance), cash flow statement (cashflow)
  • Requires the stock symbol and statement type

• get_company_overview - Get corporate overview information

  • Requires the stock symbol
  • Returns key corporate indicators and basic information

📦 Installation

Install Dependencies

npm install

Build the Project

npm run build

Development Mode (Auto Rebuild)

npm run watch

📚 Documentation

To use this server in Claude Desktop, you need to add the server configuration:

MacOS

Configuration file path: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Configuration file path: %APPDATA%/Claude/claude_desktop_config.json

Configuration example:

{
  "mcpServers": {
    "stock-market-server": {
      "command": "/path/to/stock-market-server/build/index.js"
    }
  }
}

🔧 Technical Details

Debugging

Since the MCP server communicates via standard input and output (stdio), debugging can be challenging. It is recommended to use the MCP Inspector tool for debugging:

npm run inspector

After running, the Inspector will provide a browser access address, allowing you to use debugging tools through the browser.

Technology Stack

• TypeScript
• Node.js
• Alpha Vantage API
• MCP SDK (@modelcontextprotocol/sdk)

📄 License

[Add license information]

⚠️ Important Note

• Ensure you have a valid Alpha Vantage API key before use.
• All API responses are returned in JSON format.
• Please note the call frequency limits of the Alpha Vantage API.