SC

sacahan/casualmarket

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

33 stars 9 forks 质量 70 趋势 11MIT

功能完整的台湾股票交易 Model Context Protocol (MCP) Server,提供即時股價查詢、財務分析、市場資訊等多種功能

概览

一個功能完整的**,提供超過 ,涵蓋即時股價查詢、財務分析、市場資訊、模擬交易等多種功能。基於 框架開發,具備智慧快取和頻率限制機制。 ✅ : 本地開發與 Claude Desktop 整合 ✅ : 容器化部署,HTTP 介面訪問 CasualMarket MCP Server 已发布在 PyPI,您可以直接通过 uvx 安装并在支援 MCP 的工具中使用,無需本地配置。 - Python 3.12+ - uv 套件管理器(用於執行 MCP Server) - macOS:~/Library/Application Support/Claude/claude_desktop_config.json- Windows:%APPDATA%\Claude\claude_desktop_config.json - macOS:~/Library/Application Support/Cursor/User/settings.json- Windows:%APPDATA%\Cursor\User\settings.json- Linux:~/.config/Cursor/User/settings.json - macOS:~/Library/Application Support/Code/User/settings.json- Windows:%APPDATA%\Code\User\settings.json- Linux:~/.config/Code/User/settings.json 除了 stdio 模式外,CasualMarket 也支援透過 Docker 容器化部署,並提供 SSE (Server-Sent Events) HTTP 介面。

概述(AI 翻译)

一个功能完整的台灣股票交易 MCP Server,提供超過 23 個專業工具,涵蓋即時股價查詢、財務分析、市場資訊、模擬交易等多種功能。基於 FastMCP 2.7.0+ 框架開發,智慧具備快取和頻率限制機制。

部署模式

✅ stdio 模式: 本地開發與 Claude Desktop 整合 ✅ Docker + SSE 模式: 容器化部署,HTTP 介面訪問

目錄

  • 快速開始
  • MCP 安装与配置
  • Docker 部署
  • 核心功能
  • 工具列表
  • 使用範例
  • 支援
  • 許可證

快速開始

CasualMarket MCP Server 已发布在 PyPI,您可以直接通过 uvx 安装并在支援 MCP 的工具中使用,無需本地配置。

系統需求:

  • Python 3.12+
  • uv 套件管理器(用於執行 MCP Server)

最簡單的方式是根據您使用的工具,按照下方「MCP 安裝與配置」部分進行配置即可。

MCP 安装与配置

Claude Desktop 配置

編輯 Claude Desktop 配置檔:

配置檔位置:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗口:%APPDATA%\Claude\claude_desktop_config.json

配置內容(推薦方式 - 使用 GitHub Repo):

配置內容(本地開發方式):

游标配置

编辑 Cursor 配置檔:

配置檔位置:

  • macOS:~/Library/Application Support/Cursor/User/settings.json
  • Windows:%APPDATA%\Cursor\User\settings.json
  • Linux:~/.config/Cursor/User/settings.json

配置內容:

在 settings.json 中加入以下配置:

或者直接编辑 .cursor/mcp.json:

VS Code 配置(通過 Claude 擴展)

如果使用 VS Code 中的 Claude 擴展,配置方法類似:

配置檔位置:

  • macOS:~/Library/Application Support/Code/User/settings.json
  • 窗口:%APPDATA%\Code\User\settings.json

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

CasualMarket - 台灣股票交易 MCP Server

一個功能完整的台灣股票交易 MCP Server,提供超過 23 個專業工具,涵蓋即時股價查詢、財務分析、市場資訊、模擬交易等多種功能。基於 FastMCP 2.7.0+ 框架開發,具備智慧快取和頻率限制機制。

部署模式

✅ stdio 模式: 本地開發與 Claude Desktop 整合
✅ Docker + SSE 模式: 容器化部署,HTTP 介面訪問

目錄

快速開始

CasualMarket MCP Server 已發佈在 PyPI,您可以直接透過 uvx 安裝並在支援 MCP 的工具中使用,無需本地配置。

系統需求:

最簡單的方式是根據您使用的工具,按照下方「MCP 安裝與配置」部分進行配置即可。

MCP 安裝與配置

Claude Desktop 配置

編輯 Claude Desktop 配置檔:

配置檔位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %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 配置

編輯 Cursor 配置檔:

配置檔位置:

  • macOS: ~/Library/Application Support/Cursor/User/settings.json
  • Windows: %APPDATA%\Cursor\User\settings.json
  • Linux: ~/.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 擴展)

如果使用 VS Code 中的 Claude 擴展,配置方法類似:

配置檔位置:

  • macOS: ~/Library/Application Support/Code/User/settings.json
  • Windows: %APPDATA%\Code\User\settings.json
  • Linux: ~/.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"
      }
    }
在 GitHub 查看完整 README

安装

uvx --from git+https://github.com/sacahan/CasualMarket casual-market-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "casual-market": { "command": "uvx", "args": ["--from", "git+https://github.com/sacahan/CasualMarket", "casual-market-mcp"], "env": { "LOG_LEVEL": "INFO" } } } }