@nikeandocean/carbon-factor-matcher 2.2.1 → 2.3.2

package/README.md

@@ -10,17 +10,16 @@ Carbon Factor Matcher helps AI agents find the most appropriate emission factors
 
 1. **Keyword + Embedding retrieval** — Field-weighted keyword scoring and semantic similarity to find candidate factors
 
-The calling AI agent selects the best match from the ranked candidates. No external LLM API needed.
+The calling AI agent selects the best match from the ranked candidates.
 
 ### Supported Databases
 
-- **ELCD** — European Reference Life Cycle Database (500+ factors, included in Free tier)
-- **ecoinvent 3.10** — Swiss Centre for Life Cycle Inventories (6,000+ factors, Pro license required)
-- **MEE** — China Ministry of Ecology and Environment (48 provincial/grid factors, Pro license required)
+- **ELCD** — European Reference Life Cycle Database (~600 factors, included in Free tier)
+- **ecoinvent 3.10** — Swiss Centre for Life Cycle Inventories (~6,000+ factors, Pro license required)
 
 ### Key Features
 
-- Hybrid keyword + embedding matching (DashScope text-embedding-v4)
+- Hybrid keyword + embedding matching for accurate factor retrieval
 - Multi-language support (Chinese/English activity descriptions)
 - Zero configuration — works out of the box after installation
 - MCP-compatible — works with Claude, Cursor, Windsurf, Cline, Continue, and any MCP client
@@ -128,8 +127,8 @@ The Free tier works immediately after installation (300 queries/day, ELCD databa
 
 | Plan | Price | Features |
 |------|-------|----------|
-| **Free** | $0 | ELCD database (500+ factors), keyword search, 300 queries/day |
-| **Pro** | $5 (one-time) | ELCD + ecoinvent + MEE (6,370+ factors), hybrid keyword + embedding matching, unlimited queries |
+| **Free** | $0 | ELCD database (~600 factors), keyword search, 300 queries/day |
+| **Pro** | $5 (one-time) | ELCD + ecoinvent (~6,000+ factors), hybrid keyword + embedding matching, unlimited queries |
 
 ### Purchase License Key
 
@@ -158,7 +157,7 @@ After purchase, you'll receive a license key via email. Set it as an environment
 | `CARBON_FACTOR_LICENSE_KEY` | Your license key (empty = Free tier) | — |
 | `CARBON_FACTOR_DATA_DIR` | Path to local factor database | `data/factors` |
 
-Note: No external LLM API configuration needed. The calling AI agent handles final factor selection.
+Note: No additional API configuration needed. The calling AI agent handles final factor selection.
 
 ## Available Tools
 
@@ -169,8 +168,8 @@ Match activity data to emission factors. Free tier uses keyword search; Pro tier
 **Input:**
 ```json
 {
-  "activity_data": "electricity, medium voltage, industrial grid, China, Guangdong",
-  "top_k": 5
+  "activity_data": "Factory in Shenzhen, 10kV industrial electricity, 2024, semiconductor fab",
+  "top_k": 10
 }
 ```
 
@@ -179,17 +178,12 @@ Match activity data to emission factors. Free tier uses keyword search; Pro tier
 {
   "candidates": [
     {
-      "name": "electricity, provincial grid, Guangdong (广东)",
-      "value": 0.4419,
-      "unit": "kgCO2/kWh",
-      "geography": {"location": "China, Guangdong (广东)"},
-      "source": "MEE (Ministry of Ecology and Environment), China",
-      "source_year": 2023,
-      "db_source": "mee",
-      "keyword_score": 0.8293,
-      "embedding_score": 0.6779,
-      "hybrid_score": 0.7233,
-      "final_score": 0.7233
+      "id": "elec-cn-south-10kv-2024",
+      "name": "Electricity, 10kV, South China Grid",
+      "value": 0.6101,
+      "unit": "kgCO2e/kWh",
+      "hybrid_score": 0.85,
+      "final_score": 0.875
     }
   ],
   "selection_guidance": "从候选列表中选择最匹配的排放因子..."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nikeandocean/carbon-factor-matcher",
-  "version": "2.2.1",
+  "version": "2.3.2",
   "description": "MCP server for intelligent emission factor matching — connects AI agents with carbon emission factor databases (ELCD, ecoinvent)",
   "main": "index.js",
   "bin": {