English Français العربية

ESG MCP Servers

السجل الرسمي البيانات وقواعدها

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package esg-mcp-servers
Claude Code 
claude mcp add esg-mcp-servers -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'POSTGRES_DSN=<POSTGRES_DSN>' -e 'MONGODB_URI=<MONGODB_URI>' -e 'EMBEDDING_MODEL=<EMBEDDING_MODEL>' -e 'EMBEDDING_DIMENSIONS=<EMBEDDING_DIMENSIONS>' -- uvx esg-mcp-servers==0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "esg-mcp-servers": {
            "command": "uvx",
            "args": [
                "esg-mcp-servers==0.1.2"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<your anthropic_api_key>",
                "POSTGRES_DSN": "<POSTGRES_DSN>",
                "MONGODB_URI": "<MONGODB_URI>",
                "EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
                "EMBEDDING_DIMENSIONS": "<EMBEDDING_DIMENSIONS>"
            }
        }
    }
}

متغيرات البيئة

  • ANTHROPIC_API_KEY إلزامي سري Anthropic API key — required for RAG queries and LLM-based metric extraction
  • POSTGRES_DSN إلزامي PostgreSQL connection string with pgvector extension (e.g. postgresql://esg:esg@localhost/esg_platform)
  • MONGODB_URI إلزامي MongoDB connection string for PDF binary storage via GridFS (e.g. mongodb://localhost:27017)
  • EMBEDDING_MODEL Sentence-transformer model name for embedding generation (default: Snowflake/snowflake-arctic-embed-l-v2.0)
  • EMBEDDING_DIMENSIONS Embedding vector dimension size (default: 1024)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ESG MCP Servers
  2. Quick Start
  3. Servers & Tools
  4. Claude Desktop Configuration
  5. Optional: Scraper Dependencies
  6. Development
  7. License

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
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:

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:

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:

{
  "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.

الأسئلة الشائعة

ما هو ESG MCP Servers؟

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

كيف أثبّت ESG MCP Servers؟

يعمل على جهازك. في Claude Code: claude mcp add esg-mcp-servers -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'POSTGRES_DSN=<POSTGRES_DSN>' -e 'MONGODB_URI=<MONGODB_URI>' -e 'EMBEDDING_MODEL=<EMBEDDING_MODEL>' -e 'EMBEDDING_DIMENSIONS=<EMBEDDING_DIMENSIONS>' -- uvx esg-mcp-servers==0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ESG MCP Servers إلى مفتاح API؟

نعم. يتطلب ANTHROPIC_API_KEY, POSTGRES_DSN, MONGODB_URI، وتضبطها في إعداداته.

هل ESG MCP Servers مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ESG MCP Servers؟

ينشره freminder. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.