MCP 100 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 company financial data through the Alpha Vantage API.

🚀 Quick Start

This is a TypeScript-based MCP server designed to fetch stock market data. It offers real-time stock market information and company financial data via the Alpha Vantage API.

✨ Features

Tools

• get_ticker_price - Retrieve real-time stock price

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

• get_market_report - Obtain the US market report

  • Provides an overview of the overall market conditions

• get_financial_statement - Fetch company 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 company overview information

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

📦 Installation

Set up the development environment

Install dependencies

npm install

Build the project

npm run build

Development mode (auto rebuild)

npm run watch

Installation instructions

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"
    }
  }
}

💻 Usage Examples

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.

🔧 Technical Details

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

📄 License

[Add license information]

⚠️ Important Note

You need to ensure you have a valid Alpha Vantage API key before use.

💡 Usage Tip

All API responses are returned in JSON format. Please note the call frequency limit of the Alpha Vantage API.