ping
Ping
Check that the service is up. Returns status, service name, version and server time. 確認服務狀態,回傳狀態、服務名稱、版本與伺服器時間。
無需輸入參數。

io.github.taux-io由 GitHub 帳號 taux-io 發布v0.2.6更新於 Nov 14, 2026
Unofficial. Taiwan government emission factors for AI: electricity, fuels, refrigerants, inventory.
發布方自己的服務:Carbon Fyi
非官方服務,讓助理查詢台灣政府公布的排放係數,並進行可追溯、保留版本紀錄的排放量計算。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.taux-io%2Fcarbon-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"taiwan-carbon-open-data-unofficial": {
"type": "http",
"url": "https://carbon.taux.io/mcp"
}
}
}台灣碳排係數與碳排計算 MCP。讓 Claude、ChatGPT、Cursor、Codex 等支援 MCP 的 AI 客戶端查詢台灣政府公開的碳排放係數,做可追溯、可重現的排放量計算。
讓 AI 查得到官方碳排係數、算得出排放量,也說得清楚資料來源與計算依據。
這是 taux.io 的非官方公共資料服務,不是政府網站,與資料提供機關沒有隸屬關係。計算結果僅供參考,不構成碳盤查認證、第三方查證或法定合規保證。
目前狀態:已部署在 https://carbon.taux.io。
端點:https://carbon.taux.io/mcp。Streamable HTTP,不需註冊、不需 API Key,唯讀。
其他客戶端的設定方式見首頁。
來源、授權與每一項的限制見 docs/data-sources.md。
兩件容易誤會的事:
ping、list_data_sources、search_emission_factors、match_activity、get_emission_factor、get_electricity_factor、calculate_emissions、calculate_batch、build_inventory、compare_emissions、list_factor_versions、check_factor_updates、get_methodology。
定義在 src/tools.ts;參數說明在 /tools。
要把多筆活動整理成盤查清冊的樣子,用 build_inventory(REST:POST /api/v1/inventory)。它依範疇一、二、三分類,給各範疇小計、範疇一依氣體分列,以及範疇一加二的合計。會誤導的數字不給:混用 CO2 與 CO2e、有項目算不出來、或範疇三含產品碳足跡時,對應的小計或合計會附原因扣住。範疇分類是依係數類型的預設,可逐筆用 scope 覆寫。它只涵蓋你提供的活動,不是完整的盤查。
使用者的說法不是官方係數名稱時(「10 月電費」「塑膠原料採購」),用 match_activity:它回傳候選係數、單位是否相容、適用條件與待確認事項,不會代為選定。ERP 串接時可用它把會計科目對到係數,由人確認後把 factor_id 存起來重複使用。
與 MCP 共用同一套查詢與計算邏輯(src/service.ts)。全部唯讀。
失敗的形狀是 { "ok": false, "error": { "code", "message", "details" } }。文件在 /api/docs。
需要 Node 24 以上。
資料庫只由排程寫入。seed:local 觸發的排程會匯入已審核資料、向能源署的開放資料 CSV 做一次交叉檢查,並同步 CFP_P_02(沒有金鑰就略過)。要同步 CFP_P_02,把 .dev.vars.example 複製成 .dev.vars 並填入環境部 API 金鑰。
2026-11-13 在開發機上的結果:
npm test:8 個檔案、243 項測試全部通過。npm run typecheck、npm run dry-run:通過。npm run smoke(本機 wrangler dev 與本機 D1):24 項檢查全部通過,包含兩個 MCP 協定版本的 initialize、tools/list、tools/call,以及 REST 計算。12,000 kWh 的 2025 年產業用電算出 5,592 kgCO2e,係數 0.466 讀自資料庫。CFP_P_02 同步:1,188 筆全部匯入,金鑰沒有出現在狀態端點或日誌。npm run smoke -- https://carbon.taux.io 目前 25 項(2026-11-13)檢查全部通過。第一次排程從 Cloudflare 連上了能源署與環境部,交叉檢查一致,CFP_P_02 同步 1,188 筆。missing_refrigerant_basis。紀錄在 docs/claude-directory-submission.md 的「連接器實測紀錄」。twse-mcp 共用計數。見 docs/deployment.md 的「限流」。正式環境另有每日自動檢查(對照表、冒煙測試、MCP Registry 條目),失敗時會開 issue,見 docs/deployment.md。
沒有驗證的事:
已完成:
factor_id 加 factor_version 重現過去的計算。CFP_P_02 同步程式與異常防護。llms.txt、llms-full.txt、sitemap、robots、JSON-LD。未完成或待驗證:
match_activity 靠 src/concepts.ts 的對照表把「塑膠原料」「電費」「公務車加油」對到候選係數;表裡沒有的說法(例如差旅、住宿)對不到。比對的是名稱裡的字,所以「聚丙烯」也會帶出「聚丙烯腈棉」,要由使用者確認。以包、瓶、片等件數計的係數只能查、不能算。不需帳號、不設 Cookie、不記錄你問的內容與工具參數。Cloudflare 保存連線中繼資料最長 7 天。完整內容見 https://carbon.taux.io/privacy 與 PRIVACY.md。
程式碼以 MIT 授權。資料屬各提供機關,標示政府資料開放授權條款-第1版者依該條款利用(https://data.gov.tw/license)。
來源:README.md,提交 9440f2e
Ping
Check that the service is up. Returns status, service name, version and server time. 確認服務狀態,回傳狀態、服務名稱、版本與伺服器時間。
無需輸入參數。
List data sources
List the official Taiwan government sources behind this service, with dataset codes, URLs, licence, sync status and how many factors each holds. 列出本服務整合的官方資料來源:資料集代碼、網址、授權、同步狀態與係數數量。
無需輸入參數。
Search emission factors
Search official Taiwan emission factors by keyword, category, type, year or unit. Returns factor IDs to pass to get_emission_factor and calculate_emissions. Covers electricity, tap water, fuel combustion, refrigerants and other fluorinated gases (GWP values), and product carbon footprint factors; returns an explicit not-found message rather than a near match. Refrigerant blends such as R-410A are not listed: pass their components as refrigerant_blend to calculate_emissions, calculate_batch, compare_emissions or build_inventory. 以關鍵字、類別、類型、年度或單位搜尋台灣官方排放係數,回傳的係數 ID 可交給 get_emission_factor 與 calculate_emissions。目前收錄電力、自來水、燃料燃燒、冷媒等含氟氣體(溫暖化潛勢)與產品碳足跡;查不到會明確說明,不會給相近的替代品。R-410A 這類混合冷媒不在表內,請把成分以 refrigerant_blend 交給 calculate_emissions、calculate_batch、compare_emissions 或 build_inventory 計算。
unityearlimitqueryoffsetcategoryfactor_typeMatch activity to candidate factors
Map an activity or ledger-account description (for example an electricity bill, fleet fuel, or a plastic resin purchase) plus an optional unit to candidate official factors. Returns candidates with unit compatibility, applicability conditions and the questions the user must answer; it never picks one. Use this when the user's wording is not an official factor name, then confirm with the user before calling calculate_emissions. The term mapping is curated by this service, not official. 把活動或會計科目的描述(例如電費、公務車加油、塑膠原料採購)與單位對到候選的官方係數,回傳每筆的單位相容性、適用條件與需要使用者回答的問題;不會代為選定。使用者的說法不是官方係數名稱時用這個工具,並在呼叫 calculate_emissions 之前先向使用者確認。用詞對照是本服務整理的,不是官方資料。
unityearlimitdescription必填Get emission factor
Get one factor in full by ID: the original government record, unit, applicable year, boundary, official source, version, whether it can be used for calculation directly, and usage limits. Find the ID with search_emission_factors first. 依係數 ID 取得完整資訊:官方原始紀錄、單位、適用年度、計算邊界、官方來源、版本、是否可直接計算與使用限制。請先用 search_emission_factors 找到 ID。
versionfactor_id必填Get electricity factor
Get Taiwan's official electricity emission factor (kgCO2e/kWh) for a given year, published by the Energy Administration. From the 2025 factor year there are three values by usage; earlier years have one. Never substitutes another year: if the year is missing it says so and lists the years available. 查詢經濟部能源署公布的指定年度電力排碳係數(公斤CO2e/度)。114 年度(2025)起依用途有三個數值,之前每年一個。不會以其他年度代替:該年度沒有資料時會明說並列出可用年度。
year必填usage_typeCalculate emissions
Calculate emissions for one activity: activity data × an official factor from the database. Checks units, the applicable year and whether the factor may be used for calculation, and returns the formula, kg and tonnes, the factor version and the source URL. Returns a clear error instead of guessing when the unit is incompatible, the year does not match or required data is missing (fuel factors need a user-supplied lower heating value; refrigerants need the basis of the quantity). A refrigerant blend such as R-410A can be calculated by passing refrigerant_blend with the user-supplied composition instead of factor_id. 計算單一活動的排放量:活動數據 × 資料庫中的官方係數。會檢查單位、適用年度與係數是否可用於計算,回傳公式、公斤與公噸、係數版本與來源網址。單位不相容、年度不符或缺少必要資料時(燃料係數需要使用者提供低位熱值,冷媒需要說明數量的依據)回傳明確錯誤,不會猜測。混合冷媒(如 R-410A)可不給 factor_id,改以 refrigerant_blend 提供使用者確認過的成分比例。
yearquantity必填factor_idquantity_unit必填factor_versionoptional_contextrefrigerant_blendCalculate batch
Calculate several activities at once, each with its own factor and source. A total is given only when every item succeeded and the items share a gas basis and boundary type; otherwise the reason is stated. An item may be a refrigerant blend such as R-410A: pass refrigerant_blend with the user-supplied composition instead of factor_id; it stays one row in the results, and its components count toward the total. 批次計算多筆活動,逐筆回傳結果與來源。只有全部成功、氣體基礎與邊界類型一致時才提供合計,否則說明不提供的原因。混合冷媒(如 R-410A)的項目可不給 factor_id,改以 refrigerant_blend 提供使用者確認過的成分比例;結果仍是一筆一列,合計時以各成分計入。
items必填Build GHG inventory summary
Calculate several activities and arrange the results as a greenhouse gas inventory: grouped into Scope 1 (direct), Scope 2 (purchased energy) and Scope 3 (other indirect), with a subtotal per scope, Scope 1 by gas, and a Scope 1+2 total. Subtotals and totals are withheld, with the reason, when items mix CO2 and CO2e, when an item could not be calculated, or when Scope 3 holds product carbon footprints that may overlap Scopes 1 and 2. The scope assignment is this service's default by factor type and can be overridden per item. Covers only the activities supplied; it is not a complete or verified inventory. 計算多筆活動並整理成溫室氣體盤查清冊的形式:分為範疇一(直接排放)、範疇二(能源間接)、範疇三(其他間接),提供各範疇小計、範疇一依氣體分列,以及範疇一加二的合計。項目混用 CO2 與 CO2e、有項目算不出來、或範疇三含可能與範疇一、二重疊的產品碳足跡時,不提供對應的小計或合計並說明原因。範疇分類是本服務依係數類型的預設,可逐筆覆寫。只涵蓋你提供的活動,不是完整或經查證的盤查。
items必填inventory_yearCompare emissions
Compare two calculations (for example two years). Separates the effect of changed activity data from the effect of a changed factor, and flags when the calculation method differs so the difference is not read as an actual reduction. Either side may be a refrigerant blend such as R-410A (refrigerant_blend with the user-supplied composition instead of factor_id). Two blends with the same components are split component by component; blends with different components, or a blend against a single factor, get only the difference, because a blend has no official factor of its own. 比較兩筆計算(例如不同年度)。區分活動量改變與排放係數改變的影響;計算方法不同時會標示,避免把差異誤讀為實際減碳成效。兩邊都可以是混合冷媒(如 R-410A,以 refrigerant_blend 提供使用者確認過的成分比例,不給 factor_id)。成分相同的兩個混合冷媒逐成分拆解;成分不同,或單一係數對混合冷媒,只回差額,因為混合冷媒沒有官方公布的單一係數。
baseline必填comparison必填List factor versions
List every recorded version of one factor, newest first. Old versions are kept so past calculations can be reproduced. 列出指定係數的所有歷史版本(新的在前)。舊版本會保留,讓過去的計算可以重現。
factor_id必填Check factor updates
Show the sync status of each official source: when it was last checked, whether the data may be stale, and whether a difference from the official data is waiting for review. Read-only; it cannot trigger a sync or write anything. 查看各官方來源的同步狀態:最近檢查時間、資料是否可能過期、是否有與官方資料不一致而待審核的項目。唯讀,不能觸發同步或寫入。
無需輸入參數。
Get methodology
Explain the calculation methods, scope, data limits and official references. Read this before interpreting results or combining different kinds of factors. 說明計算方法、適用範圍、資料限制與官方依據。解讀結果或合併不同類型的係數之前請先閱讀。
topic已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

fyi.carbon官方發布者
以唯讀、免金鑰的方式存取 carbon.fyi 精選的自願性碳市場新聞典藏與公開碳價資料。

由 GitHub 帳號 mrfentmen 發布
本機 MCP 伺服器,讓助理查詢英國電力碳強度、發電結構與分區電網資料。

由 GitHub 帳號 mrfentmen 發布
一個本機 MCP 伺服器,為助理提供 20 個工具,用來讀取、檢查、格式化、建立專案骨架、建置與執行 Carbon 語言程式碼。

由 GitHub 帳號 100monkeys-ai 發布
讓助理讀取、搜尋與瀏覽由頁面、原子和程式碼樹組成的工作區,並查看修訂、留言和交叉連結。

由 GitHub 帳號 jarbon 發布
CARBON Core 的 MCP 伺服器為程式開發助理提供以風險為基礎的 AI 測試流程,由 Jay 測試經理角色帶動,並產生本機證據報告。
claude mcp add --transport http carbon https://carbon.taux.io/mcpGET /api/v1/sourcesGET /api/v1/factors?query=&category=&factor_type=&year=&unit=&limit=&offset=GET /api/v1/factors/:id (可加 ?version=)GET /api/v1/factors/:id/versionsGET /api/v1/electricity?year=&usage_type=GET /api/v1/match?description=&unit=&year=&limit=POST /api/v1/calculatePOST /api/v1/calculate/batchPOST /api/v1/inventoryGET /api/v1/statusGET /healthcurl -s http://127.0.0.1:8787/api/v1/calculate \ -H 'content-type: application/json' \ -d '{"factor_id":"tw-electricity-2025-industry-inventory","quantity":12000,"quantity_unit":"kWh","year":2025}'# → "emissions_kg":"5592",附係數版本、來源網址與限制說明npm installnpm run db:local # 套用 migrations 到本機 D1npm run dev # http://127.0.0.1:8787npm run seed:local # 另開終端機:觸發一次排程,把已審核的官方資料寫進本機 D1npm run smoke # 端到端檢查npm test # 全部測試,離線npx vitest run test/engine.test.ts # 單一檔案npm run typechecknpm run dry-run # 確認 Worker 能 bundle