SET-MCP

Acesse demonstrações financeiras, incluindo receitas, balanços patrimoniais e fluxo de caixa, de empresas listadas na Bolsa de Valores da Tailândia (SET).

GitHub
13
Experimente este MCPPatrocinado

Documentação

SET-MCP

smithery badge

SET-MCP é um pacote Python que fornece ferramentas para servir o Model Context Protocol, que pode acessar a Bolsa de Valores da Tailândia (SET). Ele permite que agentes de IA recuperem demonstrações financeiras abrangentes, incluindo demonstrações de resultados, balanços patrimoniais e demonstrações de fluxo de caixa para empresas listadas.

Recursos

  • Recuperar demonstrações financeiras para empresas listadas na SET
  • Suporte para múltiplos tipos de demonstrações financeiras:
    • Demonstração de Resultados
    • Balanço Patrimonial
    • Demonstração de Fluxo de Caixa
  • Recuperação de dados históricos com intervalos de datas personalizáveis
  • Interface de linha de comando para fácil integração
  • Integração FastMCP para funcionalidade aprimorada

Instalação

O pacote requer Python 3.11 ou superior. Você pode instalá-lo usando pip:

pip install set-mcp

Instalando via Smithery

Para instalar o set-mcp para Claude Desktop automaticamente via Smithery:

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

Uso

Interface de Linha de Comando

O pacote fornece uma interface de linha de comando para fácil acesso aos dados financeiros:

set-mcp --transport stdio

Usando com uvx

Execute

uvx set-mcp

Usando com pipx

pipx install set-mcp
pipx run set-mcp

Exemplo de MCP.json

{
    "mcpServers": {
      "set_mcp": {
        "command": "/path/to/bin/uvx", // Edit to your uvx path
        "args": [
            "set-mcp"
        ],
      }
    }
}

Vercel

Em breve

Opções disponíveis:

  • --port: Porta para escutar em SSE (padrão: 8000)
  • --host: Host para escutar (padrão: 0.0.0.0)
  • --transport: Tipo de transporte (opções: stdio, sse, padrão: stdio)

Nota: SSE ainda não foi implementado

API Python

Você também pode usar o pacote programaticamente em seu código Python:

from set_mcp import get_financial_statement

# Get financial statements for a specific company
result = await get_financial_statement(
    symbol="PTT",  # Company symbol
    from_year=2023,
    to_year=2024
)

Desenvolvimento

Configurar Ambiente de Desenvolvimento

  1. Clone o repositório:
git clone https://github.com/yourusername/set-mcp.git
cd set-mcp
  1. Crie e ative um ambiente virtual:
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. Instale as dependências de desenvolvimento:
pip install -e ".[dev]"

Executando Testes

python test_client.py

A saída não deve conter erros

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Autor