SET-MCP

SET-MCP 是一个 Python 包，提供用于服务模型上下文协议的工具，该协议可以访问泰国证券交易所（SET）。它允许 AI 代理检索上市公司的综合财务报表，包括损益表、资产负债表和现金流量表。

特性

• 检索上市公司的财务报表
• 支持多种类型的财务报表：
  • 损益表
  • 资产负债表
  • 现金流量表
• 可定制日期范围的历史数据检索
• 命令行界面便于集成
• 集成 FastMCP 以增强功能

安装

该包需要 Python 3.11 或更高版本。您可以使用 pip 进行安装：

pip install set-mcp

通过 Smithery 安装

要通过 Smithery 自动安装 set-mcp 到 Claude Desktop：

npx -y @smithery/cli install set-mcp --client claude

使用方法

命令行界面

该包提供了一个命令行界面，便于访问财务数据：

set-mcp --transport stdio

使用 uvx

运行

uvx set-mcp

使用 pipx

pipx install set-mcp
pipx run set-mcp

MCP.json 示例

{
    "mcpServers": {
      "set_mcp": {
        "command": "/path/to/bin/uvx", // 编辑为您自己的 uvx 路径
        "args": [
            "set-mcp"
        ],
      }
    }
}

Vercel

即将推出

可用选项：

• --port：监听 SSE 的端口（默认：8000）
• --host：监听的主机（默认：0.0.0.0）
• --transport：传输类型（可选值：stdio, sse，默认：stdio）

注意：SSE 尚未实现

Python API

您还可以在 Python 代码中编程使用该包：

from set_mcp import get_financial_statement

# 获取特定公司的财务报表
result = await get_financial_statement(
    symbol="PTT",  # 公司代码
    from_year=223,
    to_year=224
)

开发

设置开发环境

1. 克隆仓库：

git clone https://github.com/yourusername/set-mcp.git
cd set-mcp

2. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

3. 安装开发依赖项：

pip install -e ".[dev]"

运行测试

python test_client.py

输出应无错误

许可证

本项目采用 MIT 许可证——详情见 LICENSE 文件。

贡献

欢迎贡献！请随时提交 Pull Request。

作者

• Prem Chotipanit (prem.ch@ku.th | prem.chotepanit@gmail.com)