# π TWStockMCPServer
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io/)
[](https://github.com/twjackysu/TWStockMCPServer/actions/workflows/api-tests.yml)
A comprehensive **Model Context Protocol (MCP) server** designed for Taiwan Stock Exchange (TWSE) data analysis, providing real-time stock information, financial statements, ESG data, and trend analysis functionality.
<a href="https://glama.ai/mcp/servers/@twjackysu/TWSEMCPServer">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@twjackysu/TWSEMCPServer/badge" />
</a>
## π Language Versions
- **English** | [ηΉι«δΈζ](README.md)
## π¬ Demo
### VSCode Copilot demo
### Gemini CLI demo
*Watch TWStockMCPServer in action*
## β¨ Five Investment Analysis Scenarios
### π **Individual Stock Trend Analysis**
Comprehensive analysis combining technical, fundamental, and institutional trading perspectives
> *"Analyze TSMC (2330) recent trends" / "Is Hon Hai (2317) suitable for long-term investment?"*
### π° **Foreign Investment Insights**
Foreign holdings, industry flows, and individual stock entry/exit tracking
> *"What stocks are foreign investors buying recently?" / "How are foreign investment trends in semiconductors?"*
### π₯ **Market Hotspot Detection**
Major announcements, abnormal trading volumes, warrant activity monitoring
> *"What major news happened today?" / "Which stocks have abnormal trading volumes?"*
### π **Dividend Investment Planning**
High-yield screening, ex-dividend calendar, payout stability analysis
> *"Recommend some high-yield stocks" / "Which companies go ex-dividend next month?"*
### π― **Investment Screening**
Value/growth stock selection, ESG risk assessment
> *"Help me find some undervalued stocks" / "Which companies have good ESG performance?"*
## π API Integration Progress
Current Progress: **38/143 (26.6%)** Completed β
Want to understand detailed API coverage? Check our **[API TODO List](API_TODO.md)** to track implementation progress!
> π‘ Run `python generate_todo.py` to automatically update progress statistics
## βοΈ Quick Start
### π Online Usage (Recommended)
```json
{
"twstockmcpserver": {
"transport": "streamable_http",
"url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
}
}
```
### π§ Local Installation
```bash
git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev server.py
```
## π€ Contributing
PRs welcome! Check the existing [API list](API_TODO.md) to understand expandable features.
## π License & Disclaimer
MIT License | For reference only, not investment advice
