CasualMarket - 台灣股票交易 MCP Server
一個功能完整的台灣股票交易 MCP Server,提供超過 23 個專業工具,涵蓋即時股價查詢、財務分析、市場資訊、模擬交易等多種功能。基於 框架開發,具備智慧快取和頻率限制機制。
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट 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
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
CasualMarket stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। 功能完整的台灣股票交易 Model Context Protocol (MCP) Server,提供即時股價查詢、財務分析、市場資訊等多種功能