Metadata-Version: 2.4
Name: iflow-mcp_parsedark-mcp_stock
Version: 0.1.0
Summary: Stock Analysis MCP Server - Provides various tools for accessing and analyzing stock market data
Requires-Python: >=3.8
Requires-Dist: adata>=2.9.2
Requires-Dist: akshare>=1.16.95
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: crawl4ai>=0.6.3
Requires-Dist: fastmcp>=2.5.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.9.1
Requires-Dist: numpy>=2.2.6
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pandas>=2.2.3
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: requests>=2.32.3
Requires-Dist: scikit-learn>=1.6.1
Requires-Dist: tavily-python>=0.7.2
Description-Content-Type: text/markdown

# Stock Analysis MCP Server

This project is a server built using the `FastMCP` framework, providing various tools for accessing and analyzing stock market data.

## Features

The server exposes the following tools:

*   **Concept Power Tools (`/stock`)**: Analyzes the strength of stock concept sectors based on fund flow and price change.
*   **Finance Tools (`/finance`)**: Provides access to stock financial core indicators and company information.
*   **Stock F10 Tools (`/f10`)**: Fetches and summarizes Stock F10 information.
*   **Market Emotion Tools (`/market`)**: Retrieves and summarizes A-share market emotion indicators.
*   **Stock Keep Up Tools (`/stockUp`)**: Provides lists of continuous limit-up stocks and limit-up stocks.
*   **Web Search Tools (Tavily) (`/websearch`)**: Provides a web search tool.

## Setup and Installation

1.  **Clone the repository:**

    ```bash
    git clone <repository_url>
    cd mcp_stock
    ```

2.  **Create a virtual environment (recommended):**

    ```bash
    python -m venv venv
    source venv/bin/activate
    ```

3.  **Install dependencies:**

    Install the required packages using pip:

    ```bash
    pip install -r requirements.txt
    playwright install
    ```

4.  **Configuration:**

    Some tools might require API keys or other configuration. Please refer to the `config.py` file and potentially create a `.env` file if necessary (based on `os.getenv` usage in `server.py`).
    ```
    TAVILY_API_KEY=
    ```

5.  **Run the server:**

    You can run the server using the `server.py` script. The server will listen on the port specified by the `PORT` environment variable, defaulting to 8000.

    ```bash
    fastmcp run server.py --transport=sse --port=8000 --host=0.0.0.0
    ```

    To run on a specific port:

    ```bash
    fastmcp run server.py --transport=sse --port=8000 --host=0.0.0.0
    ```

## Usage

Once the server is running, you can interact with the tools via the `/mcp` prefix followed by the tool's mount path (e.g., `/mcp/stock`, `/mcp/finance`). The specific endpoints and expected parameters for each tool can be found by examining the tool definitions within each tool's Python file. 