ESG Hub MCP Server

ESG Hub

Ascent Partners Foundationによる、環境・社会・ガバナンス（ESG）に関するオープンアクセスの百科事典 — 350件以上の記事、厳選された240件以上のリソース、書籍、コース、AI 検索、公開 REST API、MCP サーバーを提供しています。英語、簡体字中国語、繁体字中国語（香港）に対応しています。

公開サイト： esg-hub.ascent.partners

概要

• ナレッジベース — 基準（GRI、IFRS S1/S2、TCFD、TNFD、ESRS）、規制、フレームワーク、評価、地域別（香港／APAC）ガイダンスを網羅する350件以上のESG記事
• AI 検索 — 自然言語で質問できます。ナレッジベースに基づいた回答を提供します（SurrealDB BM25 + ベクトル検索、DeepSeek、信頼性の高いESGドメインを対象としたBrave Search）
• 公開 REST API — すべてのコンテンツにオープンアクセスで利用できます：/api/v1
• MCP サーバー — AI エージェントを直接接続できます：@esg-hub/mcp-server
• 学習リソース — 無料のコース、書籍、厳選された動画ライブラリ
• i18n — 英語、簡体字中国語（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の中核テーブルです。

デプロイ

本番環境は、container.jsonで宣言されたダイジェスト固定のコンテナとして、ecs-01/02/03のHAフリート上で稼働しています。デプロイ対象はイメージであり、ノード上のリリースツリーではありません。フリートはこれを: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 fleet（コンテナ化）

クイックスタート（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 エージェントがナレッジベースを検索して読み取るためのツールを提供します

コントリビューション

• コンテンツの誤り（誤った情報、古い情報、リンク切れ）：コンテンツの誤りに関するIssueを作成してください
• バグとコードの変更： CONTRIBUTING.mdを参照してください
• セキュリティの脆弱性： SECURITY.mdから非公開で報告してください

Context7 での使用

最新の ESG Hub ドキュメントは Context7 にインデックス化されているため、コーディングエージェントは必要に応じてコンテキストに取り込めます。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 で ⭐ を付けていただけると、ほかの人にも見つけてもらいやすくなります。