MCP Trader

🚀 MCP Trader Stock Analysis Server Documentation

MCP Trader is a stock analysis tool based on the MCP protocol, offering technical analysis capabilities. It can be run via the Command Line Interface (CLI) or in HTTP service mode.

🚀 Quick Start

MCP Trader can be installed and run in different modes. Here are the basic steps:

Quick Installation

pip install mcp-trader

Run in Command Line Mode

mcpTrader analyze --symbol AAPL --timeframe daily

Run as an HTTP Service

mcpTrader serve --port 8000

✨ Features

• Technical Analysis: Includes trend analysis, momentum indicators, volatility, and volume analysis.
• Relative Strength Analysis: Evaluates a stock's performance relative to the market and other stocks.
• Multi-tool Support:
  • Trend Analysis
  • Momentum Analysis
  • Volatility Analysis
  • Volume Analysis
  • Relative Strength Analysis
  • Interest Rate Analysis
  • Money Flow Analysis
  • Support & Resistance Analysis

📦 Installation

Quick Installation

pip install mcp-trader

💻 Usage Examples

Basic Usage

Analyze Apple stock in the command line:

mcpTrader analyze --symbol AAPL --period 2Y --indicator RSI,MACD,VOLUME

Output Result Example

Basic Information

• Stock Symbol: AAPL
• Current Price: $150.25
• Volatility: 12.4%
• Trading Volume: 1,200,000 shares

Technical Indicators

Trend Analysis

• Current Trend: Uptrend
• Support Level: $140
• Resistance Level: $160

Trading Signals

• Momentum Indicator: bullish
• Money Flow: positive

📚 Documentation

Configuration File Example

{
  "apiKey": "your_api_key_here",
  "dataSources": {
    "primary": "yahoo Finance",
    "secondary": "alphavantage"
  },
  "logging": {
    "level": "INFO",
    "enabled": true
  }
}

Configuration Parameter Explanation

[API]
KEY=your_api_key_here
ENDPOINT=yahoo.finance.com

[DATA]
PERIOD=DAILY
RESOLUTION=1D

Dependencies

- requests >=2.31.0
- mcp >=1.4.0
- numpy ==1.26.5
- pandas >=3.0.5
- ta-lib >=0.7.0
- python-dotenv >=1.0.2

🔧 Technical Details

Development and Contribution

Contribution Guidelines

• Fork the repository.
• Create a feature branch: git checkout -b feature/new_analyzer.
• Commit your code and create a Pull Request.

Issue Feedback

To report bugs or suggest improvements, visit GitHub Issues.

📄 License

This project is licensed under the MIT License. For detailed information, please refer to the LICENSE file.

Contact Information

• Email: support@mcpTrader.com
• Official Website: MCPTrader

Thank you for using the MCP Trader stock analysis tool! For more information, please visit our official website.