Sobre o projeto

O open-esg-korea é um servidor MCP (Model Context Protocol) que permite consultar informações de ESG de empresas listadas na Coreia do Sul diretamente em clientes de IA usando linguagem natural. Desenvolvido por um analista de valores mobiliários, utiliza a mesma estrutura do projeto irmão open-proxy-mcp (análise de divulgações DART). ■ Fontes e Métodos de Dados O servidor consolida classificações ESG/E/S/G de cinco instituições (KCGS, MSCI, Korea ESG Institute, S&P, Sustinvest) do Portal ESG da KRX, textos originais de relatórios de governança corporativa e de sustentabilidade do KIND (extração de PDF), e dados de emissões de gases estufa do GIR (Centro de Informações Integradas de Gases Estufa). Nenhuma das três fontes requer chaves de API; as classificações não são armazenadas, mas recuperadas em tempo real a cada pergunta, acompanhadas de fonte, ano e termos de uso. ■ Instalação Basta baixar o arquivo .mcpb correspondente à plataforma (macOS Apple Silicon/Intel ~40-44MB, Windows x64 ~43MB) nas releases e arrastá-lo para a tela de extensões nas configurações do Claude Desktop. Como o runtime do Python está embutido, não são necessários Python, ferramentas de desenvolvimento ou chaves de API. Para o ChatGPT, orienta-se a conexão via Codex (CLI, extensão de IDE, app). O arquivo de instalação contém o runtime, dependências (mcp, httpx, pypdfium2, pdfplumber), o servidor, manifesto e informações de build. ■ As 12 Ferramentas company (consulta de nome/código da empresa), esg_ratings (classificações por instituição e distribuição interna), sustainability_reports (lista de relatórios, agências de verificação, links PDF), sustainability_report_text (busca por palavras-chave, excertos e visualização de páginas em PDF), governance_indicators (15 indicadores principais O/X e taxa de conformidade), governance_policies (74 itens de política), governance_report (texto original, respostas a 28 princípios detalhados e motivos de não conformidade), esg_disclosures (histórico de divulgações), esg_screener (rastreador de classificações para todo o mercado de ações, 795 empresas em 2025), ghg_emissions (emissões por empresa, tendência de 5 anos e relação com a cota de emissões), ghg_industry (ranking de emissões por setor designado e entidade), ghg_national_inventory (série temporal do inventário nacional desde 1990). ■ Observações de Leitura O sistema orienta a não comparar classificações lado a lado, pois as escalas variam (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E). O símbolo '-' indica 'não avaliado', não sendo necessariamente uma nota baixa. Devido ao número limitado de níveis, não é fornecido o 'Top N%', mas sim a contagem dentro da mesma instituição. Os sistemas de setores diferem entre GICS (25 grupos), Portal (21 setores) e GIR. Para o KOSDAQ, apenas a tabela de classificações está disponível. A governança é respondida em duas camadas: agregação da KRX e texto original da empresa; se o texto não puder ser lido, é marcado como 'não lido' em vez de '0 conformidades'. Para gases estufa, o escopo (fronteira, método Scope 2, inclusão de NF₃) é apresentado antes do valor; se ausente no GIR, é exibido como no_data. A extração automática de tabelas de relatórios é experimental (preservação de valores de 97,4%, com avisos em células suspeitas) e a busca em PDF ignora espaços entre caracteres, não lendo PDFs de imagem sem OCR. Os números de protocolo são do KIND, diferindo do visualizador DART. ■ Atenção à Licença O código é Apache-2.0, permitindo uso comercial, modificação e distribuição gratuita, desde que a fonte seja citada. No entanto, esta licença não se aplica aos dados recuperados. As classificações ESG são obras intelectuais de cada agência e todas proíbem a divulgação externa. Portanto, para coletar, armazenar, redistribuir, revender ou criar produtos com as classificações, deve-se consultar cada instituição. Por isso, o servidor não mantém as classificações fora do cache de memória e solicita que o campo de licença nas respostas não seja removido. ■ Para Desenvolvedores Após instalar as dependências com uv, pode-se executar via python -m open_esg_korea (HTTP, localhost:8000/mcp) ou --transport stdio, registrando-o no claude_desktop_config.json para conexão local. O script scripts/build_mcpb.py permite build de extensões por plataforma, e --check verifica se as 12 ferramentas respondem conforme o manifesto. Testes são executados via pytest sem rede. Estão inclusos scripts de atualização de classificação GICS e lista de empresas, scripts de probe/smoke para esquemas KRX e acesso KIND, além de documentos de rascunho e notas de medição do MCP.