CasualMarket - 台灣股票交易 MCP Server
一個功能完整的台灣股票交易 MCP Server,提供超過 23 個專業工具,涵蓋即時股價查詢、財務分析、市場資訊、模擬交易等多種功能。基於 框架開發,具備智慧快取和頻率限制機制。
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด✅ stdio 模式: 本地開發與 Claude Desktop 整合
✅ Docker + SSE 模式: 容器化部署,HTTP 介面訪問
CasualMarket MCP Server 已發佈在 PyPI,您可以直接透過 uvx 安裝並在支援 MCP 的工具中使用,無需本地配置。
系統需求:
最簡單的方式是根據您使用的工具,按照下方「MCP 安裝與配置」部分進行配置即可。
編輯 Claude Desktop 配置檔:
配置檔位置:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json配置內容(推薦方式 - 使用 GitHub Repo):
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
配置內容(本地開發方式):
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "/path/to/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
編輯 Cursor 配置檔:
配置檔位置:
~/Library/Application Support/Cursor/User/settings.json%APPDATA%\Cursor\User\settings.json~/.config/Cursor/User/settings.json配置內容:
在 settings.json 中加入以下配置:
{
"mcpServerSettings": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
或者直接編輯 .cursor/mcp.json:
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
如果使用 VS Code 中的 Claude 擴展,配置方法類似:
配置檔位置:
~/Library/Application Support/Code/User/settings.json%APPDATA%\Code\User\settings.json~/.config/Code/User/settings.json配置內容:
{
"claude.mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
對於支援 MCP 協定的其他工具,通用配置範本:
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
MCP Server 支援以下環境變數:
API 和快取相關:
限速相關:
監控相關:
推薦配置範例(快速開始):
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO",
"MARKET_MCP_API_TIMEOUT": "10",
"MARKET_MCP_CACHE_TTL": "1800",
"MARKET_MCP_CACHE_MAX_SIZE": "1000"
}
}
}
}
高效能配置範例(啟用限速和監控):
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "INFO",
"MARKET_MCP_API_TIMEOUT": "15",
"MARKET_MCP_CACHE_TTL": "3600",
"MARKET_MCP_CACHE_MAX_SIZE": "2000",
"MARKET_MCP_CACHE_MAX_MEMORY_MB": "500",
"MARKET_MCP_RATE_LIMITING_ENABLED": "true",
"MARKET_MCP_RATE_LIMIT_INTERVAL": "2.0",
"MARKET_MCP_RATE_LIMIT_GLOBAL_PER_MINUTE": "100"
}
}
}
}
調試配置範例(詳細日誌):
{
"mcpServers": {
"casual-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"],
"env": {
"LOG_LEVEL": "DEBUG",
"MARKET_MCP_API_TIMEOUT": "20",
"MARKET_MCP_CACHE_TTL": "600",
"MARKET_MCP_CACHING_ENABLED": "true"
}
}
}
}
除了 stdio 模式外,CasualMarket 也支援透過 Docker 容器化部署,並提供 SSE (Server-Sent Events) HTTP 介面。
方式 1: 使用預構建鏡像(推薦)
# 克隆專案
git clone https://github.com/sacahan/CasualMarket.git
cd CasualMarket
# 拉取並啟動
./scripts/docker-run.sh pull
./scripts/docker-run.sh up
# 查看日誌
./scripts/docker-run.sh logs
# 測試服務
./scripts/docker-run.sh test
方式 2: 本地構建
# 構建鏡像
./scripts/docker-run.sh build
# 啟動服務
DOCKER_IMAGE_NAME=casualmarket-mcp:latest ./scripts/docker-run.sh up
方式 3: Docker Compose
# 啟動服務
docker-compose up -d
# 停止服務
docker-compose down
容器啟動後,可透過以下端點訪問:
http://localhost:8000/ - 服務資訊http://localhost:8000/health - 服務狀態http://localhost:8000/sse - MCP 協議通訊(POST)http://localhost:8000/docs - FastAPI 自動生成文檔import requests
import json
# 列出可用工具
response = requests.post(
"http://localhost:8000/sse",
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}
)
# 呼叫工具 - 查詢台積電股價
response = requests.post(
"http://localhost:8000/sse",
json={
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_taiwan_stock_price",
"arguments": {"symbol": "2330"}
}
}
)
完整的客戶端範例請參考 examples/sse_client_example.py。
詳細的 Docker 部署說明請參閱 docs/DOCKER.md。
以下是透過 Claude Desktop 或其他 MCP 客戶端使用這些工具的範例。
使用者提問:
"請查詢台積電目前的股價"
AI 回應:
AI 會自動調用 get_taiwan_stock_price 工具,參數為 "台積電" 或 "2330",然後返回即時股價、漲跌幅、成交量等資訊。
工具調用:
{
"tool": "get_taiwan_stock_price",
"arguments": {
"symbol": "2330"
}
}
使用者提問:
"幫我模擬買入 1000 股台積電"
AI 回應:
AI 會調用 buy_taiwan_stock 工具,計算手續費和總成本,並返回完整的交易結果。
工具調用:
{
"tool": "buy_taiwan_stock",
"arguments": {
"symbol": "2330",
"quantity": 1000
}
}
限價交易範例:
"以每股 510 元的價格買入 2000 股台積電"
{
"tool": "buy_taiwan_stock",
"arguments": {
"symbol": "2330",
"quantity": 2000,
"price": 510.0
}
}
使用者提問:
"請分析台積電的財務狀況,包括損益表和公司基本資料"
AI 回應: AI 會依序調用多個工具來獲取完整資訊:
{
"tool": "get_company_profile",
"arguments": {
"symbol": "2330"
}
}
{
"tool": "get_company_income_statement",
"arguments": {
"symbol": "2330"
}
}
{
"tool": "get_stock_valuation_ratios",
"arguments": {
"symbol": "2330"
}
}
使用者提問:
"我想了解台積電是否適合投資,請幫我分析股價、財務狀況、股利配息和外資持股情況"
AI 工作流程:
AI 會智慧地調用多個工具來完成綜合分析:
get_taiwan_stock_price)get_company_profile)get_stock_valuation_ratios)get_company_dividend)get_top_foreign_holdings)get_company_monthly_revenue)然後將所有資訊整合,提供完整的投資建議。
使用者提問:
"現在台股大盤的情況如何?"
AI 回應:
{
"tool": "get_real_time_trading_stats",
"arguments": {}
}
AI 會返回當前市場的即時統計,包括成交量、漲跌家數、漲停跌停股票等。
使用者提問:
"2025年10月10日是交易日嗎?"
AI 回應:
{
"tool": "check_taiwan_trading_day",
"arguments": {
"date": "2025-10-10"
}
}
AI 會告訴你該日期是否為交易日,並說明原因(是否為週末或國定假日)。
完整對話流程:
使用者: "請幫我查詢鴻海的股價,如果股價低於 100 元,就模擬買入 2000 股"
AI 執行:
get_taiwan_stock_price("鴻海") 查詢股價buy_taiwan_stock("2317", 2000)使用者: "今天外資買超最多的是哪些股票?"
AI 執行:
get_top_foreign_holdings() 獲取外資持股資訊MIT License - 詳見 LICENSE 檔案
更新時間: 2025年10月22日
版本: 0.1.0
功能完整的台灣股票交易 Model Context Protocol (MCP) Server,提供即時股價查詢、財務分析、市場資訊等多種功能
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
CasualMarket ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 功能完整的台灣股票交易 Model Context Protocol (MCP) Server,提供即時股價查詢、財務分析、市場資訊等多種功能