ESG MCP服务器
开源 模型上下文协议 用于ESG（环境、社会和治理）数据提取、分析和监管管理的服务器。
31工具 跨6台服务器——安装一次，只运行您需要的东西。
作者 扬尼斯·米科斯(johnmichos.tf@gmail.com)
快速开始
pip install esg-mcp-servers先决条件
| 服务 | 需要 |
|---|---|
| PostgreSQL 16+pgvector | 向量存储、度量、规则 |
| MongoDB 7 | PDF二进制存储（GridFS） |
| 人类API密钥 | RAG查询，度量提取 |
使用Docker启动本地数据库：
docker compose up -d运行数据库迁移：
esg-mcp-migrate环境变量
复制 .env.example 并填写您的值：
cp .env.example .env关键变量：
| 变量 | 默认值 | 描述 |
|---|---|---|
POSTGRES_DSN | postgresql://esg:esg@localhost/esg_platform | PostgreSQL连接字符串 |
MONGODB_URI | mongodb://localhost:27017 | MongoDB连接字符串 |
ANTHROPIC_API_KEY | -- | RAG和LLM提取所需 |
EMBEDDING_MODEL | Snowflake/snowflake-arctic-embed-l-v2.0 | 句子转换模型 |
EMBEDDING_DIMENSIONS | 1024 | 嵌入向量大小 |
服务器和工具
esg指标提取器（11个工具）
ESRS对排放、能源、水、废物、社会和治理领域进行了KPI提取。
| 工具 | 说明 |
|---|---|
extract_emissions_data | 温室气体范围1、2、3提取 |
extract_energy_data | 能源消耗和可再生能源（ESRS E2） |
extract_water_data | 取水、排水、用水量（ESRS E3） |
extract_waste_data | 废物产生、回收、填埋（ESRS E5） |
extract_social_data | 劳动力、多样性、健康与安全（ESRS S1） |
extract_governance_data | 董事会组成和治理（ESRS G1） |
answer_esg_query | 自由文本RAG文档问答 |
keyword_similarity_search | 文档中的语义关键字搜索 |
detect_query_domain | 将查询分类到ESG域 |
detect_emissions_query_type | 从查询中检测排放范围/年 |
batch_extract_metrics | 提取所有KPI并保存到数据库 |
esg pdf处理器（5个工具）
PDF验证、文本/表格提取和嵌入生成。
| 工具 | 说明 |
|---|---|
verify_esg_report | RandomForest ESG报告分类器 |
extract_text_chunks | 提取并分割PDF文本 |
extract_tables | 使用OCR回退进行表格提取 |
generate_embeddings | 批量嵌入生成 |
process_pdf_full_pipeline | 端到端：提取、嵌入、存储 |
esg矢量库（5个工具）
pgvector用于文档块和查询缓存的CRUD操作。
| 工具 | 说明 |
|---|---|
upsert_document_chunks | 插入/更新带有嵌入的块 |
similarity_search | 余弦相似度搜索 |
get_cached_query_response | 检索缓存的LLM响应 |
cache_query_response | 将LLM响应存储在缓存中 |
list_documents | 列出索引文档 |
esg法规（5种工具）
欧盟ESG法规下载、摄取和语义搜索。
| 工具 | 说明 |
|---|---|
download_regulation | 从EUR Lex下载法规PDF |
download_all_regulations | 批量下载所有配置的法规 |
ingest_regulation | 提取、解析文章、嵌入、存储 |
search_regulation_text | 跨监管文章的语义搜索 |
list_regulations | 列出摄入的法规 |
esg刮刀（5个工具）
从网络上发现和下载ESG报告。
| 工具 | 说明 |
|---|---|
search_esg_reports | ESG PDF的多引擎搜索 |
crawl_company_website | PDF链接的深度抓取网站 |
download_pdf | 下载PDF并存储在GridFS中 |
get_scraping_status | 检查刮擦作业状态 |
cancel_scraping_job | 取消正在运行的抓取作业 |
esg mcp全部（31个工具）
来自所有服务器的所有工具都在一个进程中。
Claude桌面配置
添加到您的 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"
}
}
}或者对所有工具使用组合服务器：
{
"mcpServers": {
"esg": {
"command": "esg-mcp-all"
}
}
}可选：刮刀依赖关系
scraper服务器需要Selenium用于JavaScript密集型网站：
pip install esg-mcp-servers[scraper]发展
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许可证
麻省理工学院——见 许可证.