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 分