This project is a server built using the FastMCP
framework, providing various tools for accessing and analyzing stock market data.
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.
-
Clone the repository:
git clone <repository_url> cd mcp_stock
-
Create a virtual environment (recommended):
python -m venv venv source venv/bin/activate
-
Install dependencies:
Install the required packages using pip:
pip install -r requirements.txt playwright install
-
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 onos.getenv
usage inserver.py
).TAVILY_API_KEY=
-
Run the server:
You can run the server using the
server.py
script. The server will listen on the port specified by thePORT
environment variable, defaulting to 8000.fastmcp run server.py --transport=sse --port=8000 --host=0.0.0.0
To run on a specific port:
fastmcp run server.py --transport=sse --port=8000 --host=0.0.0.0
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.