ESG MCP Servers

io.github.freminder由 GitHub 账号 freminder 发布v0.1.2更新于 Oct 24, 2026

31 MCP tools for ESG data extraction, PDF processing, vector search, and EU regulation analysis.

已验证STDIO仅桌面网页搜索与抓取知识与记忆数据与分析

概览

AI 生成的概览

一套本地 Python MCP 服务器，用于 ESG 工作：从 PDF 提取可持续性指标、存储向量嵌入并检索欧盟法规。

可以做什么
从报告中提取符合 ESRS 的 KPI（排放、能源、水、废弃物、社会、治理）并写入数据库，同时支持基于文档的自由文本 RAG 问答和语义关键词搜索。校验、分块并提取 PDF 表格，生成嵌入并执行完整的提取-嵌入-存储流程。在 pgvector 中插入和相似度检索文档分块，缓存和读取 LLM 查询响应，列出已索引文档。从 EUR-Lex 下载欧盟法规、解析条款并做语义检索。通过网页搜索或站点爬取发现并下载 ESG 报告 PDF，查看任务状态并取消正在运行的爬取任务。
适用场景
适合可持续发展、ESG 报告或合规工作，需要助手从企业报告中提取 KPI、维护可检索的文档向量库或查询欧盟法规文本时使用。适合能在本地运行或通过网络访问 PostgreSQL（含 pgvector）和 MongoDB 的用户。
运行要求
以本地 Python 包形式运行（pip install esg-mcp-servers），仅限桌面。需要带 pgvector 的 PostgreSQL 16（POSTGRES_DSN）、用于 PDF 存储的 MongoDB 7（MONGODB_URI），以及用于 RAG 和 LLM 提取的 Anthropic API 密钥（ANTHROPIC_API_KEY）。对 JavaScript 较多的站点爬取需可选安装 Selenium；使用前须运行数据库迁移命令。
安装前请注意
需要 Anthropic API 密钥，会产生使用费用，数据库连接串可能包含凭据。相关工具会写入和修改数据库（分块写入、缓存响应、法规入库），并从网络和 EUR-Lex 下载文件。爬取和抓取会向第三方网站发送请求，批量运行前请先确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ESG MCP Servers，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ESG MCP Servers

Open-source Model Context Protocol servers for ESG (Environmental, Social, and Governance) data extraction, analysis, and regulation management.

31 tools across 6 servers — install once, run only what you need.

Author: Ioannis Michos ([email protected])

Quick Start

bash
pip install esg-mcp-servers

Prerequisites

ServiceRequired for
PostgreSQL 16 + pgvectorVector storage, metrics, regulations
MongoDB 7PDF binary storage (GridFS)
Anthropic API keyRAG queries, metric extraction

Spin up local databases with Docker:

bash
docker compose up -d

Run the database migration:

bash
esg-mcp-migrate

Environment Variables

Copy .env.example and fill in your values:

bash
cp .env.example .env

Key variables:

VariableDefaultDescription
POSTGRES_DSNpostgresql://esg:esg@localhost/esg_platformPostgreSQL connection string
MONGODB_URImongodb://localhost:27017MongoDB connection string
ANTHROPIC_API_KEY—Required for RAG and LLM extraction
EMBEDDING_MODELSnowflake/snowflake-arctic-embed-l-v2.0Sentence-transformer model
EMBEDDING_DIMENSIONS1024Embedding vector size

Servers & Tools

esg-metrics-extractor (11 tools)

ESRS-aligned KPI extraction for emissions, energy, water, waste, social, and governance domains.

ToolDescription
extract_emissions_dataGHG Scope 1, 2, 3 extraction
extract_energy_dataEnergy consumption & renewables (ESRS E2)
extract_water_dataWater withdrawal, discharge, consumption (ESRS E3)
extract_waste_dataWaste generation, recycling, landfill (ESRS E5)
extract_social_dataWorkforce, diversity, H&S (ESRS S1)
extract_governance_dataBoard composition & governance (ESRS G1)
answer_esg_queryFree-text RAG Q&A over documents
keyword_similarity_searchSemantic keyword search in documents
detect_query_domainClassify query into ESG domain
detect_emissions_query_typeDetect emissions scope/year from query
batch_extract_metricsExtract all KPIs and persist to DB

esg-pdf-processor (5 tools)

PDF validation, text/table extraction, and embedding generation.

ToolDescription
verify_esg_reportRandomForest ESG report classifier
extract_text_chunksExtract and chunk PDF text
extract_tablesTable extraction with OCR fallback
generate_embeddingsBatch embedding generation
process_pdf_full_pipelineEnd-to-end: extract, embed, store

esg-vector-store (5 tools)

pgvector CRUD operations for document chunks and query cache.

ToolDescription
upsert_document_chunksInsert/update chunks with embeddings
similarity_searchCosine similarity search
get_cached_query_responseRetrieve cached LLM responses
cache_query_responseStore LLM response in cache
list_documentsList indexed documents

esg-regulations (5 tools)

EU ESG regulation download, ingestion, and semantic search.

ToolDescription
download_regulationDownload regulation PDF from EUR-Lex
download_all_regulationsBatch download all configured regulations
ingest_regulationExtract, parse articles, embed, store
search_regulation_textSemantic search across regulation articles
list_regulationsList ingested regulations

esg-scraper (5 tools)

ESG report discovery and download from the web.

ToolDescription
search_esg_reportsMulti-engine search for ESG PDFs
crawl_company_websiteDeep-crawl website for PDF links
download_pdfDownload PDF and store in GridFS
get_scraping_statusCheck scrape job status
cancel_scraping_jobCancel running scrape job

esg-mcp-all (31 tools)

All tools from all servers in a single process.

Claude Desktop Configuration

Add to your claude_desktop_config.json:

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"    }  }}

Or use the combined server for all tools:

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

Optional: Scraper Dependencies

The scraper server requires Selenium for JavaScript-heavy sites:

bash
pip install esg-mcp-servers[scraper]

Development

bash
git clone https://github.com/freminder/esg-mcp-servers.gitcd esg-mcp-serverspip install -e ".[scraper,dev]"docker compose up -desg-mcp-migrate

License

MIT — see LICENSE.

来源：README.md，提交 86f4ec0

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分