AI导哈

ESG数据管理工具

开源ESG（环境、社会和治理）数据提取、分析和法规管理工具集，包含31个工具，适用于企业ESG报告处理和法规遵从。

  • by freminder
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 freminder/esg-mcp-servers

使用说明

ESG MCP服务器

开源 模型上下文协议 用于ESG（环境、社会和治理）数据提取、分析和监管管理的服务器。

31工具 跨6台服务器——安装一次，只运行您需要的东西。

作者 扬尼斯·米科斯(johnmichos.tf@gmail.com)

快速开始

pip install esg-mcp-servers

先决条件

服务 需要
PostgreSQL 16+pgvector 向量存储、度量、规则
MongoDB 7 PDF二进制存储（GridFS）
人类API密钥 RAG查询，度量提取

使用Docker启动本地数据库：

docker compose up -d

运行数据库迁移：

esg-mcp-migrate

环境变量

复制 .env.example 并填写您的值：

cp .env.example .env

关键变量：

变量 默认值 描述
POSTGRES_DSN postgresql://esg:esg@localhost/esg_platform PostgreSQL连接字符串
MONGODB_URI mongodb://localhost:27017 MongoDB连接字符串
ANTHROPIC_API_KEY -- RAG和LLM提取所需
EMBEDDING_MODEL Snowflake/snowflake-arctic-embed-l-v2.0 句子转换模型
EMBEDDING_DIMENSIONS 1024 嵌入向量大小

服务器和工具

esg指标提取器（11个工具）

ESRS对排放、能源、水、废物、社会和治理领域进行了KPI提取。

工具 说明
extract_emissions_data 温室气体范围1、2、3提取
extract_energy_data 能源消耗和可再生能源（ESRS E2）
extract_water_data 取水、排水、用水量（ESRS E3）
extract_waste_data 废物产生、回收、填埋（ESRS E5）
extract_social_data 劳动力、多样性、健康与安全（ESRS S1）
extract_governance_data 董事会组成和治理（ESRS G1）
answer_esg_query 自由文本RAG文档问答
keyword_similarity_search 文档中的语义关键字搜索
detect_query_domain 将查询分类到ESG域
detect_emissions_query_type 从查询中检测排放范围/年
batch_extract_metrics 提取所有KPI并保存到数据库

esg pdf处理器（5个工具）

PDF验证、文本/表格提取和嵌入生成。

工具 说明
verify_esg_report RandomForest ESG报告分类器
extract_text_chunks 提取并分割PDF文本
extract_tables 使用OCR回退进行表格提取
generate_embeddings 批量嵌入生成
process_pdf_full_pipeline 端到端：提取、嵌入、存储

esg矢量库（5个工具）

pgvector用于文档块和查询缓存的CRUD操作。

工具 说明
upsert_document_chunks 插入/更新带有嵌入的块
similarity_search 余弦相似度搜索
get_cached_query_response 检索缓存的LLM响应
cache_query_response 将LLM响应存储在缓存中
list_documents 列出索引文档

esg法规（5种工具）

欧盟ESG法规下载、摄取和语义搜索。

工具 说明
download_regulation 从EUR Lex下载法规PDF
download_all_regulations 批量下载所有配置的法规
ingest_regulation 提取、解析文章、嵌入、存储
search_regulation_text 跨监管文章的语义搜索
list_regulations 列出摄入的法规

esg刮刀（5个工具）

从网络上发现和下载ESG报告。

工具 说明
search_esg_reports ESG PDF的多引擎搜索
crawl_company_website PDF链接的深度抓取网站
download_pdf 下载PDF并存储在GridFS中
get_scraping_status 检查刮擦作业状态
cancel_scraping_job 取消正在运行的抓取作业

esg mcp全部（31个工具）

来自所有服务器的所有工具都在一个进程中。

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "esg-metrics": {
      "command": "esg-metrics-extractor"
    },
    "esg-pdf": {
      "command": "esg-pdf-processor"
    },
    "esg-vectors": {
      "command": "esg-vector-store"
    },
    "esg-regulations": {
      "command": "esg-regulations"
    },
    "esg-scraper": {
      "command": "esg-scraper"
    }
  }
}

或者对所有工具使用组合服务器：

{
  "mcpServers": {
    "esg": {
      "command": "esg-mcp-all"
    }
  }
}

可选：刮刀依赖关系

scraper服务器需要Selenium用于JavaScript密集型网站：

pip install esg-mcp-servers[scraper]

发展

git clone https://github.com/freminder/esg-mcp-servers.git
cd esg-mcp-servers
pip install -e ".[scraper,dev]"
docker compose up -d
esg-mcp-migrate

许可证

麻省理工学院——见 许可证.

相关 MCP