ESG Hub MCP Server

ESG Hub

由 Ascent Partners Foundation 打造的开放访问环境、社会和治理（ESG）知识百科全书——350 多篇文章、240 多项精选资源、书籍、课程、AI 搜索、公共 REST API 和 MCP 服务。提供英语、简体中文和繁体中文（香港）版本。

在线网站： esg-hub.ascent.partners

概览

• 知识库——350 多篇 ESG 文章，涵盖标准（GRI、IFRS S1/S2、TCFD、TNFD、ESRS）、法规、框架、评级和区域（香港／亚太地区）指南
• AI 搜索——用自然语言提问；答案以知识库为依据（SurrealDB BM25 + 向量搜索、DeepSeek、Brave Search，搜索权威 ESG 领域内容）
• 公共 REST API——开放访问所有内容：/api/v1
• MCP 服务——直接连接 AI Agent：@esg-hub/mcp-server
• 学习资源——免费课程、书籍和精选视频库
• 国际化——英语、简体中文（zh）、繁体中文——香港（hk）

架构

flowchart TB
  U["User / AI agent"] --> WEB["Next.js 16 App Router · React 19<br/>next-intl (en / zh / hk)"]
  WEB --> DB[("SurrealDB Cloud<br/>BM25 + vector search")]
  WEB --> AI["DeepSeek + Brave Search<br/>grounded answers"]
  WEB --> API["Public REST API · /api/v1"]
  API --> MCP["MCP server<br/>@simonmak-ascent/esg-hub-mcp"]
  V["APG ALB · esg-hub.ascent-partners.com"] --> WEB

如何回答查询

sequenceDiagram
  autonumber
  actor U as User
  participant W as Next.js app (App Router)
  participant API as /api/ai-search · /api/ai-chat
  participant S as search.ts
  participant DB as SurrealDB (page · section · embedding)
  participant AI as DeepSeek
  participant X as Brave / OpenAlex
  U->>W: ask a question
  W->>API: POST query (+ locale)
  API->>S: search(query)
  S->>DB: BM25 keyword + vector (embedding) hybrid ranking
  DB-->>S: ranked pages / sections + citations
  API->>AI: synthesize answer from ranked context
  API->>X: enrich (web + research)
  X-->>API: references
  API-->>W: streamed answer + citations
  W-->>U: grounded response

数据模型

erDiagram
  PAGE ||--o{ SECTION : contains
  SECTION ||--o{ EMBEDDING : "vectorised as"
  FRAMEWORK ||--o{ PAGE : classifies
  INDUSTRY ||--o{ PAGE : tags
  TERM ||--o{ PAGE : defines
  PAGE {
    string id
    string slug
    string title
    string lang
  }
  SECTION {
    string id
    string heading
    text body
  }
  EMBEDDING {
    vector vector
    string model
  }

FRAMEWORK、INDUSTRY 和 TERM 是 /api/v1/* REST 资源公开的分类维度；page、section 和 embedding 是 SurrealDB 的核心表。

部署

生产环境在 ecs-01/02/03 高可用集群上运行，使用 container.json 中声明的固定摘要容器——镜像就是可部署产物，而非节点上的发布目录。集群以容器形式在 :3210 端口运行该服务，没有任何节点运行路由 Web 服务器。ALB 负责终止 TLS，并将 esg-hub.ascent.partners 的请求路由到容器端口。原 Vercel 项目已停用。集群部署详情请参阅 apg-infra。

flowchart LR
  DEV["git push / PR"] --> CI["GitHub Actions<br/>lint · test · e2e · health-check"]
  CI -->|merge to main| IMG["digest-pinned image<br/>container.json"]
  IMG -->|the image is the deployable| PROD["container · :3210"]
  ALB["APG ALB · TLS termination"] -->|esg-hub.ascent.partners| PROD
  PROD --> SURF["/api/mcp · /api/v1<br/>MCP + REST surfaces"]

技术栈

Next.js 16（App Router、React 19）· SurrealDB Cloud · Tailwind CSS v4 · next-intl · Vitest + Playwright · APG 集群（容器化）

快速开始（≤ 5 分钟）

**最快方式——无需安装任何内容：**使用在线网站和开放 API。

• 网站： https://esg-hub.ascent.partners
• API（无需身份验证）： GET https://esg-hub.ascent.partners/api/v1/pages

运行本地副本：

git clone https://github.com/simonmak-ascent/esg-hub.git
cd esg-hub
pnpm install        # note: requires sibling repo ../tool_package (private)
cp .env.example .env  # fill in your own values
pnpm dev

常用命令：pnpm lint · npx tsc --noEmit · npx vitest run · pnpm verify:db

**注意：**应用会从 SurrealDB 数据库中渲染内容——若要运行完整副本，需要自备数据库实例和内容。公共网站和 API 均可免费访问，无需运行任何内容。

API 与 MCP

• **REST API：**开放访问，无需身份验证——GET /api/v1/pages、/api/v1/search?q=...、/api/v1/resources、/api/v1/meta（文档）
• **MCP 服务：**请参阅 mcp-server/——为 AI Agent 提供搜索和阅读知识库的工具

参与贡献

• 内容错误（信息有误／过时、链接失效）：提交内容错误问题
• **程序错误和代码更改：**请参阅 CONTRIBUTING.md
• **安全漏洞：**通过 SECURITY.md 私下报告

与 Context7 配合使用

最新的 ESG Hub 文档已编入 Context7 索引，编码 Agent 可按需将其载入上下文。安装 Context7 MCP 服务或 ctx7 CLI 后，在提示词中指定库名称：

use library /simonmak-ascent/esg-hub for API and docs

许可证

• 代码： MIT
• 百科内容： Ascent Partners Foundation 提供的 CC BY-SA 4.0

---

这是 Ascent Partners Foundation 的项目。

如果它为你节省了时间，在 GitHub 上点个 ⭐ 就能帮助其他人找到它。