Log inSubmit server
Esg MCP Servers logo

Esg MCP Servers

Extracts ESG metrics, processes PDFs, searches vector data, and analyzes EU regulations through 31 MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Esg MCP Servers

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "esg-mcp-servers": {
      "command": "uvx",
      "args": [
        "esg-mcp-servers"
      ],
      "env": {
        "POSTGRES_DSN": "YOUR_VALUE_HERE",
        "MONGODB_URI": "YOUR_VALUE_HERE",
        "ANTHROPIC_API_KEY": "YOUR_VALUE_HERE",
        "EMBEDDING_MODEL": "YOUR_VALUE_HERE",
        "EMBEDDING_DIMENSIONS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The esg-mcp-servers MCP server provides 31 tools for extracting ESG metrics, processing reports, searching indexed content, and managing regulations. It runs as six focused servers or as one combined process, using PostgreSQL with pgvector for vectors and metrics, MongoDB GridFS for PDF files, and Anthropic for RAG and LLM extraction. Tools cover ESRS-aligned emissions, energy, water, waste, social, and governance data, along with PDF parsing, web discovery, and EU regulation search. Reach for it when an agent needs to turn ESG reports and regulatory documents into searchable, structured data.

Use cases

  • Extract ESRS metrics from sustainability reports
  • Process ESG PDFs into searchable embeddings
  • Search EU regulation articles semantically
  • Discover and download company ESG reports
  • Cache and answer ESG document questions

Key features

  • ESRS-aligned KPI extraction
  • PDF text and table processing with OCR fallback
  • pgvector similarity search and response caching
  • EUR-Lex regulation download and article search
  • ESG report web discovery and PDF download
  • Combined process exposing all 31 tools

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · esg-mcp-servers (PyPI)

How Esg MCP Servers works

What esg-mcp-servers does

The esg-mcp-servers MCP server groups 31 tools into six server processes for ESG document workflows. The metrics extractor handles ESRS-aligned data across emissions, energy, water, waste, social, and governance topics. It also provides free-text question answering, semantic keyword search, query-domain detection, emissions query classification, and batch KPI extraction with database persistence.

The PDF processor validates reports, extracts text and tables, supports OCR fallback for tables, creates embeddings, and can run the full processing pipeline. The vector store manages document chunks and query-response caching in PostgreSQL with pgvector. The regulation server downloads configured EU regulations from EUR-Lex, parses and indexes them, and searches their articles semantically.

The scraper searches for ESG reports, crawls company websites for PDF links, downloads files into MongoDB GridFS, and exposes job status and cancellation operations.

How it works

Install the Python package, provide the database and model configuration, start the supporting services, and run the migration command. Documents can be discovered or downloaded, processed into chunks and embeddings, stored in PostgreSQL, and queried through semantic search or RAG tools. Regulation files follow a similar download, extraction, embedding, and storage flow.

Each capability can run as its own MCP process: esg-metrics-extractor, esg-pdf-processor, esg-vector-store, esg-regulations, or esg-scraper. esg-mcp-all exposes all 31 tools from one process. This layout lets a client load only the server groups it needs.

Setup and configuration

Install with pip install esg-mcp-servers. PostgreSQL 16 with pgvector is required for vector storage, metrics, and regulations. MongoDB 7 is required for PDF binary storage. Anthropic access is required for RAG queries and LLM-based metric extraction. The repository includes Docker Compose support for starting local databases, followed by esg-mcp-migrate for schema setup.

Set POSTGRES_DSN, MONGODB_URI, and ANTHROPIC_API_KEY in the environment. EMBEDDING_MODEL defaults to Snowflake/snowflake-arctic-embed-l-v2.0, while EMBEDDING_DIMENSIONS defaults to 1024. Install the optional [scraper] extra when using Selenium-dependent scraping for JavaScript-heavy sites.

Claude Desktop can register each executable separately or use the combined esg-mcp-all command. The project is licensed under MIT.

Tools and capabilities

The esg-mcp-servers MCP server supports these workflow areas:

  • Extract ESRS-aligned environmental, social, and governance metrics.
  • Validate, parse, chunk, and embed PDF reports.
  • Store document vectors and cache query responses.
  • Download and search EU regulation articles.
  • Discover ESG reports and manage scraping jobs.
  • Run all listed tools through one combined MCP process.

Limitations and notes

The README identifies PostgreSQL, MongoDB, and Anthropic requirements by feature rather than as a single universal dependency set. The scraper’s Selenium dependency is optional but needed for JavaScript-heavy sites. The provided client configuration documents Claude Desktop; other clients are not described in the project material. Embedding model and vector dimensions must remain compatible with the stored embeddings and database configuration.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Esg MCP Servers

esg-mcp-servers is an MCP server that connects to PostgreSQL with pgvector, MongoDB GridFS, and Anthropic services for ESG workflows. Its main tools extract ESRS-aligned metrics, process PDFs, generate embeddings, search documents and regulations, download reports, and answer ESG questions with retrieval-augmented generation.

Install it with `pip install esg-mcp-servers`. Start the required databases with Docker Compose, configure the environment variables, and run `esg-mcp-migrate` before launching one of the server commands.

It requires PostgreSQL 16 with pgvector for vector storage, metrics, and regulations, plus MongoDB 7 for PDF binary storage in GridFS. Anthropic access is required for RAG queries and LLM-based extraction.

Yes. Claude Desktop can launch each server executable separately or run `esg-mcp-all` to expose all 31 tools through one MCP process.

Selenium is optional and is needed by the scraper for JavaScript-heavy websites. Install the package with the `[scraper]` extra when that scraping capability is required.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEsg MCP Servers AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/esg-mcp-servers?style=directory)](https://allmcps.com/mcp/esg-mcp-servers)
HTML Embed
<a href="https://allmcps.com/mcp/esg-mcp-servers"><img src="https://allmcps.com/api/badge/esg-mcp-servers?style=directory" alt="Esg MCP Servers on AllMCPs" /></a>