feat: Integrate TWSE market data tools via MCP bridge

[JasonWang1124]

Summary

Closes #109

Adds 29 Taiwan Stock Exchange (TWSE) tools to OpenAlice, bridging the TWSEMCPServer into the existing tool system via MCP HTTP transport.

• New: src/domain/twstock/client.ts — MCP client with lazy-connect (connects on first tool call)
• New: src/domain/twstock/config.ts — Config reader for data/config/twstock.json (gitignored)
• New: src/tool/twstock.ts — 29 tool definitions using existing Zod + factory pattern
• Modified: src/main.ts — Conditional registration + shutdown hook
• Modified: .gitignore — Add services/ for local MCP server clones

Tools added

Category	Count	Examples
Company Info	6	Profile, balance sheet, income statement, revenue, dividends, news
ESG & Governance	5	Governance, climate, risk, security, supply chain
Trading Data	6	Daily/monthly/yearly OHLCV, monthly average, P/E ratio, real-time stats
Market Indices	2	Index info (major/sector/ESG/thematic), historical TAIEX
Foreign Investment	2	Top holdings, by industry
Margin Trading	1	Margin/short balances
Dividends & ETF	2	Ex-dividend schedule, ETF regular investment ranking
TWSE News	2	Official news, events
Warrants	3	Basic info, daily trading, trader count

Design choices

• Opt-in: No config file or empty mcpUrl → zero tools registered, zero impact
• No hardcoded URLs: Endpoint read from gitignored data/config/twstock.json
• Lazy connection: OpenAlice starts normally even if TWSE server is unavailable
• Follows existing patterns: Identical structure to equity.ts, market.ts, etc.
• Minimal existing code changes: Only main.ts touched (3 imports + 6 lines registration + 1 line shutdown)

Setup

# 1. Clone and start TWSEMCPServer locally
git clone https://github.com/twjackysu/TWSEMCPServer.git services/twstock-mcp
cd services/twstock-mcp && uv sync
uv run fastmcp run server.py --transport streamable-http --port 3010

# 2. Create config
echo '{"enabled": true, "mcpUrl": "http://localhost:3010/mcp"}' > data/config/twstock.json

# 3. Start OpenAlice
pnpm dev

Test plan

• TypeScript compiles with zero errors (npx tsc --noEmit)
• OpenAlice starts and registers 71 tools (42 existing + 29 twstock)
• Tested 13 tools across all categories via direct MCP client calls — all returned correct data
• End-to-end test via chat API — AI successfully calls twstockGetCompanyProfile and returns formatted TSMC data
• Verified opt-in: without config, tool count stays at 42
• Benchmarked local vs remote: local HTTP is ~5-7x faster for most endpoints

🤖 Generated with Claude Code