Back to Browse
Free
Server data from the Official MCP Registry
31 MCP tools for ESG data extraction, PDF processing, vector search, and EU regulation analysis.
About
31 MCP tools for ESG data extraction, PDF processing, vector search, and EU regulation analysis.
Security Report
4.3
Use Caution4.3High RiskValid MCP server (1 strong, 1 medium validity signals). 6 known CVEs in dependencies (1 critical, 3 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
3 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Anthropic API key — required for RAG queries and LLM-based metric extractionRequired
Environment variable: ANTHROPIC_API_KEY
PostgreSQL connection string with pgvector extension (e.g. postgresql://esg:esg@localhost/esg_platform)
Environment variable: POSTGRES_DSN
MongoDB connection string for PDF binary storage via GridFS (e.g. mongodb://localhost:27017)
Environment variable: MONGODB_URI
Sentence-transformer model name for embedding generation (default: Snowflake/snowflake-arctic-embed-l-v2.0)
Environment variable: EMBEDDING_MODEL
Embedding vector dimension size (default: 1024)
Environment variable: EMBEDDING_DIMENSIONS
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-freminder-esg-mcp-servers": {
"env": {
"MONGODB_URI": "your-mongodb-uri-here",
"POSTGRES_DSN": "your-postgres-dsn-here",
"EMBEDDING_MODEL": "your-embedding-model-here",
"ANTHROPIC_API_KEY": "your-anthropic-api-key-here",
"EMBEDDING_DIMENSIONS": "your-embedding-dimensions-here"
},
"args": [
"esg-mcp-servers"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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 (johnmichos.tf@gmail.com)
Quick Start
pip install esg-mcp-servers
Prerequisites
| Service | Required for |
|---|---|
| PostgreSQL 16 + pgvector | Vector storage, metrics, regulations |
| MongoDB 7 | PDF binary storage (GridFS) |
| Anthropic API key | RAG queries, metric extraction |
Spin up local databases with Docker:
docker compose up -d
Run the database migration:
esg-mcp-migrate
Environment Variables
Copy .env.example and fill in your values:
cp .env.example .env
Key variables:
| Variable | Default | Description |
|---|---|---|
POSTGRES_DSN | postgresql://esg:esg@localhost/esg_platform | PostgreSQL connection string |
MONGODB_URI | mongodb://localhost:27017 | MongoDB connection string |
ANTHROPIC_API_KEY | — | Required for RAG and LLM extraction |
EMBEDDING_MODEL | Snowflake/snowflake-arctic-embed-l-v2.0 | Sentence-transformer model |
EMBEDDING_DIMENSIONS | 1024 | Embedding vector size |
Servers & Tools
esg-metrics-extractor (11 tools)
ESRS-aligned KPI extraction for emissions, energy, water, waste, social, and governance domains.
| Tool | Description |
|---|---|
extract_emissions_data | GHG Scope 1, 2, 3 extraction |
extract_energy_data | Energy consumption & renewables (ESRS E2) |
extract_water_data | Water withdrawal, discharge, consumption (ESRS E3) |
extract_waste_data | Waste generation, recycling, landfill (ESRS E5) |
extract_social_data | Workforce, diversity, H&S (ESRS S1) |
extract_governance_data | Board composition & governance (ESRS G1) |
answer_esg_query | Free-text RAG Q&A over documents |
keyword_similarity_search | Semantic keyword search in documents |
detect_query_domain | Classify query into ESG domain |
detect_emissions_query_type | Detect emissions scope/year from query |
batch_extract_metrics | Extract all KPIs and persist to DB |
esg-pdf-processor (5 tools)
PDF validation, text/table extraction, and embedding generation.
| Tool | Description |
|---|---|
verify_esg_report | RandomForest ESG report classifier |
extract_text_chunks | Extract and chunk PDF text |
extract_tables | Table extraction with OCR fallback |
generate_embeddings | Batch embedding generation |
process_pdf_full_pipeline | End-to-end: extract, embed, store |
esg-vector-store (5 tools)
pgvector CRUD operations for document chunks and query cache.
| Tool | Description |
|---|---|
upsert_document_chunks | Insert/update chunks with embeddings |
similarity_search | Cosine similarity search |
get_cached_query_response | Retrieve cached LLM responses |
cache_query_response | Store LLM response in cache |
list_documents | List indexed documents |
esg-regulations (5 tools)
EU ESG regulation download, ingestion, and semantic search.
| Tool | Description |
|---|---|
download_regulation | Download regulation PDF from EUR-Lex |
download_all_regulations | Batch download all configured regulations |
ingest_regulation | Extract, parse articles, embed, store |
search_regulation_text | Semantic search across regulation articles |
list_regulations | List ingested regulations |
esg-scraper (5 tools)
ESG report discovery and download from the web.
| Tool | Description |
|---|---|
search_esg_reports | Multi-engine search for ESG PDFs |
crawl_company_website | Deep-crawl website for PDF links |
download_pdf | Download PDF and store in GridFS |
get_scraping_status | Check scrape job status |
cancel_scraping_job | Cancel 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:
{
"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:
{
"mcpServers": {
"esg": {
"command": "esg-mcp-all"
}
}
}
Optional: Scraper Dependencies
The scraper server requires Selenium for JavaScript-heavy sites:
pip install esg-mcp-servers[scraper]
Development
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
License
MIT — see LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Productivity MCP Servers
Memory
Freeby Modelcontextprotocol · Productivity
Knowledge graph-based persistent memory across sessions
81.5K
Stars
10
Installs
8.0
Security
No ratings yet
Local
Time
Freeby Modelcontextprotocol · Productivity
Time and timezone conversion capabilities for your AI assistant
80.0K
Stars
1
Installs
9.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local