nace-mcp

nace-mcp

一个 MCP 服务，为 AI Agent 提供 NACE Rev. 2.1 经济活动分类代码。

NACE（经济活动分类）是欧洲用于对经济活动进行分类的标准。此服务会在启动时将全部 1,047 个代码加载到内存中，并提供四种工具，用于浏览、查询、搜索和模糊匹配代码，而不会向 Agent 一次性倾倒完整数据集。

MCP 配置

添加到你的 Claude（或任何兼容 MCP 的客户端）配置中：

{
  "mcpServers": {
    "nace-mcp": {
      "command": "npx",
      "args": ["nace-mcp"]
    }
  }
}

工具

nace_get(code)

返回单个 NACE 代码的完整详情。

输入： code——例如 "A"、"01"、"25.1"、"25.11"

输出示例：

{
  "code": "95.31",
  "label": "Repair and maintenance of motor vehicles",
  "level": "class",
  "parent": "95.3"
}

---

nace_browse(parent_code?)

返回某个代码的直接子项（精简格式：仅包含代码和标签）。省略 parent_code 可列出全部 22 个顶级类别。最多返回 50 条结果。

输入： parent_code（可选）——例如 "C"、"25"、"25.1"

示例——nace_browse()（不带参数）：

[
  { "code": "A", "label": "Agriculture, forestry and fishing" },
  { "code": "B", "label": "Mining and quarrying" },
  { "code": "C", "label": "Manufacturing" },
  ...
]

示例——nace_browse("J")：

[
  { "code": "58", "label": "Publishing activities" },
  { "code": "59", "label": "Motion picture, video and television programme production, sound recording and music publishing activities" },
  { "code": "60", "label": "Programming, broadcasting, news agency and other content distribution activities" },
  ...
]

---

nace_search(query)

在所有活动标签中进行不区分大小写的子字符串搜索。最多返回 10 条匹配结果。

输入： query——例如 "software"、"fishing"、"consulting"

示例——nace_search("software")：

[
  { "code": "58.1", "label": "Publishing of books, newspapers and other publishing activities, except software publishing", "level": "group" },
  { "code": "58.19", "label": "Other publishing activities, except software publishing", "level": "class" },
  { "code": "58.2", "label": "Software publishing", "level": "group" },
  { "code": "58.29", "label": "Other software publishing", "level": "class" }
]

---

nace_suggest(activity_description)

将自由文本描述与 NACE 代码进行模糊匹配。此工具会对输入进行分词，根据匹配词项评分，并返回排名前 5 的候选项及简要说明。适用于执行分类任务的 AI Agent。

输入： activity_description——经济活动的自由文本描述

示例——nace_suggest("computer programming software development consultancy")：

[
  {
    "code": "62",
    "label": "Computer programming, consultancy and related activities",
    "level": "division",
    "reason": "Matched: \"computer\", \"programming\", \"consultancy\""
  },
  {
    "code": "62.1",
    "label": "Computer programming activities",
    "level": "group",
    "reason": "Matched: \"computer\", \"programming\""
  },
  {
    "code": "62.10",
    "label": "Computer programming activities",
    "level": "class",
    "reason": "Matched: \"computer\", \"programming\""
  },
  ...
]

提示： 对于非英语描述（例如德语“KFZ Mechaniker”），调用 nace_suggest 前请先改写为英文。

---

提示词示例

以下示例展示 AI Agent 如何在实际场景中使用这些工具。

---

“汽车修理店适用哪个 NACE 代码？”

Agent 使用英文描述调用 nace_suggest：

nace_suggest("motor vehicle repair maintenance workshop")

[
  {
    "code": "95",
    "label": "Repair and maintenance of computers, personal and household goods, and motor vehicles and motorcycles",
    "level": "division",
    "reason": "Matched: \"motor\", \"vehicle\", \"repair\", \"maintenance\""
  },
  {
    "code": "95.3",
    "label": "Repair and maintenance of motor vehicles and motorcycles",
    "level": "group",
    "reason": "Matched: \"motor\", \"vehicle\", \"repair\", \"maintenance\""
  },
  {
    "code": "95.31",
    "label": "Repair and maintenance of motor vehicles",
    "level": "class",
    "reason": "Matched: \"motor\", \"vehicle\", \"repair\", \"maintenance\""
  }
]

随后，Agent 使用 nace_get("95.31") 深入查看最佳匹配项，以确认其上级代码链：

{
  "code": "95.31",
  "label": "Repair and maintenance of motor vehicles",
  "level": "class",
  "parent": "95.3"
}

结果： 95.31 是汽车修理店对应的正确类别级代码。

---

“哪个 NACE 代码涵盖面包店？”

nace_suggest("bakery bread pastry production")

[
  {
    "code": "10.71",
    "label": "Manufacture of bread; manufacture of fresh pastry goods and cakes",
    "level": "class",
    "reason": "Matched: \"bread\", \"pastry\""
  }
]

结果： 10.71——第一个候选项完全匹配，无需进一步导航。

---

“探索信息与通信行业”

Agent 自上而下浏览层级结构：

nace_browse("J")

[
  { "code": "58", "label": "Publishing activities" },
  { "code": "59", "label": "Motion picture, video and television programme production, sound recording and music publishing activities" },
  { "code": "60", "label": "Programming, broadcasting, news agency and other content distribution activities" },
  { "code": "61", "label": "Telecommunications" },
  { "code": "62", "label": "Computer programming, consultancy and related activities" },
  { "code": "63", "label": "Information service activities" }
]

然后深入查看第 62 类：

nace_browse("62")

[
  { "code": "62.1", "label": "Computer programming activities" },
  { "code": "62.2", "label": "Computer consultancy and computer facilities management activities" },
  { "code": "62.3", "label": "Computer facilities management activities" },
  { "code": "62.9", "label": "Other information technology and computer service activities" }
]

---

数据

• 来源： jnsprnw/nace-codes——由社区维护的 JSON 格式转换数据，内容基于 Eurostat 官方 NACE Rev. 2.1 分类
• 覆盖范围： 共 1,047 条，涵盖 22 个类别（A–U）和 4 个层级（类别 → 部门 → 组 → 类）
• 权威来源： Eurostat NACE Rev. 2.1

开发

npm install
npm run build    # compile TypeScript → dist/
node dist/index.js  # run the server (listens on stdio)

使用 MCP Inspector 进行检查：

npx @modelcontextprotocol/inspector node dist/index.js