planslurpen MCP

“Planslurpen MCP Server” 可以翻译为“Planslurpen 的 MCP 服务器”。不过，这里的“Planslurpen”可能是一个特定的项目名、服务器名或社区名，如果它没有特定的官方中文译名，通常会直接保留原名。所以，完整的翻译可以是：“Planslurpen 的 MCP 服务器”或者根据上下文简化为“Planslurpen MCP 服务器”

一个用于交互的模型上下文协议（MCP）服务器 “Planslurpen”这个单词看起来像是一个虚构或特定语境下的词汇，并没有直接的中文对应翻译。如果尝试根据其可能的构成进行推测，“Plans”可能指的是“计划”，“lurpen”则可能是一个创造性的词缀或特定领域的术语，没有直接的中文含义。因此，如果这是一个特定语境或虚构作品中的词汇，建议直接根据上下文或作品设定来翻译或解释。如果仅从字面结构上尝试翻译，可以勉强将其拆解为“计划（Plans）+ 某种特定含义（lurpen，此处无法准确翻译）”，但这样的拆解并不具有实际意义。在实际应用中，建议寻找该词在具体语境中的含义或解释这是一项挪威服务，利用人工智能来解读区域规划和管理条例（reguleringsplaner）。

关于Planslurpen（注：此词可能为特定语境或虚构名称，直接翻译为“计划吞噬者”或保持原样，具体含义需根据上下文确定）

Planslurpen是建筑质量局（Direktoratet for byggkvalitet）推出的一项测试服务，它提供基于机器的挪威法规计划解读。该服务利用人工智能从法规计划中提取参数，并在有子区域（delområder）划分时进行子区域拆分。其目标是为需要的系统提供结构化的计划信息。

特点/功能

这个MCP服务器提供了以下工具：

• 检索计划解释 按市镇编号和计划ID
• 通过房产地址查询计划 使用地籍编号
• 下载计划输出文件 以JSON和XML（NPAD）格式
• 获取可用字段和分类 用于过滤
• 接入计划条款 （计划条款）——原始法律文本
• 灵活的响应格式 （JSON 或 Markdown）

安装

先决条件

• Python 3.10或更高版本
• pip

设置

1. 克隆或下载此目录

1. 安装依赖项：

pip install -r requirements.txt

1. 使服务器可执行（可选）：

chmod +x planslurpen_mcp.py

使用方法

运行服务器

服务器可以直接运行：

python planslurpen_mcp.py

Claude 桌面配置

将此添加到您的Claude桌面配置文件中：

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "planslurpen": {
      "command": "python",
      "args": ["/absolute/path/to/planslurpen_mcp/planslurpen_mcp.py"]
    }
  }
}

替换 /absolute/path/to/planslurpen_mcp/ 以及此目录的实际路径。

可用工具

1. planslurpen_get_plan

通过市镇编号和计划ID检索人工智能解释的计划数据。

参数：

• kommunenummer （必填）：4位数的市镇编号（例如，豪格松的编号为“1106”）
• plan_id （必填）：计划标识符（例如，“RL791”）
• versjon （可选）：具体版本号
• response_format （可选）：“json”或“markdown”（默认：“json”）

示例：

Get plan interpretation for Haugesund kommune 1106, plan RL791, version 3

2. planslurpen_get_plan_by_id

通过其UUID检索计划数据。

参数：

• plan_uuid （必填）：计划的 UUID
• response_format （可选）：“json”或“markdown”

3. planslurpen_get_plan_output_json

下载完整的计划输出，格式为JSON，并可选择应用过滤条件。

参数：

• kommunenummer （必填）：市镇编号
• plan_id （必填）：计划ID
• versjon （可选）：版本号
• felt_kode （可选）：用于过滤的字段代码（例如，“byggehøyde”（建筑高度），“utnyttingsgrad”（利用率））
• klassifikasjoner （可选）：用于过滤的分类列表
• response_format （可选）：“json”或“markdown”

提示： 呼叫 planslurpen_get_plan_fields 首先查看可用的过滤器！

4. planslurpen_get_plan_fields

获取计划中可用字段和分类的列表。

参数：

• kommunenummer （必填）：市政区编号
• plan_id （必填）：计划ID
• versjon （可选）：版本号
• response_format （可选）：“json”或“markdown”

用例： 首先调用此方法，以发现您可以在其他工具中使用哪些过滤器。

5. planslurpen_get_plan_provisions

下载计划条款（planbestemmelser）——原始法律文本。

参数：

• kommunenummer （必填）：市镇编号
• plan_id （必填）：计划ID
• versjon （可选）：版本号

6. planslurpen_get_plan_output_xml

下载NPAD XML格式的计划输出文件。

参数：

• kommunenummer （必填）：市镇编号
• plan_id （必填）：计划ID
• versjon （可选）：版本号

7. planslurpen_lookup_property

通过地籍地址查询特定房产的规划方案。

参数：

• kommunenummer （必填）：市镇编号
• gardsnummer （必填）：农场/地籍编号
• bruksnummer （必填）：包裹编号
• festenummer （可选）：租赁权编号
• seksjonsnummer （可选）：章节编号
• response_format （可选）：“json”或“markdown”

示例：

Look up plans for property 1106-45-123

示例查询

以下是一些你可以尝试在Claude上使用的示例查询：

1. 获取计划解释：

> “获取Haugesund市（编号1106）的规划解读，规划编号RL791，版本3”

1. 查询房产信息：

> “豪格松1106-45-123号房产适用哪些法规计划？”

1. 探索可用数据：

> “在编号为1106的市镇中，计划RL791有哪些可用的领域和分类？”

1. 获取过滤后的数据：

> “获取规划编号1106/RL791的建筑高度（building height）数据”

挪威语术语

• “Kommune”在中文中通常翻译为“公社”或“社区”（根据上下文，有时也可能译为“市镇”或“自治市”，但“公社”或“社区”更为常见）。这个词源自德语，常用于描述一种集体或自治的组织形式。市镇/市政区
• 规划方案/调控计划分区/规划方案
• 计划中的具体规定或条款计划条款（法律文本）
• “Delområde”翻译成中文是“领域”或“范围”。这个词汇在挪威语中表示一个特定的区域或范围，可以用于描述知识、活动、研究等多个方面的界限或范围。计划内的子区域
• “Gardsnummer”在中文中可以翻译为“门牌号”或“地块编号”，具体取决于上下文。如果是指住宅或建筑物的编号，通常翻译为“门牌号”；如果是指土地或地块的编号，则可能翻译为“地块编号”。农场/地籍编号
• 使用编号包裹编号
• 节目重头戏租赁编号
• “Seksjonsnummer”翻译成中文是“段落编号”或“章节编号”，具体取决于上下文，如果是在文档或书籍中，可能指的是章节或部分的编号。章节编号
• 利用率利用度/容积率
• 建筑高度建筑高度
• NPAD（注：NPAD本身是一个缩写或特定术语，根据上下文可能有不同的含义，此处直接保留原样翻译）挪威规划数据（XML标准）

API信息

• 基本URLhttps://planslurpen.no/api（该网址本身不直接翻译，但可表述为）：计划吞噬（或计划吞噬者）.no 的 API 端口
• Swagger 文档https://planslurpen.no/api/swagger/index.html 的中文翻译可以是：“https://planslurpen.no/api/swagger/index.html（Swagger API 文档界面）”。不过，通常在实际应用中，我们不会直接翻译网址，而是解释其用途或提供访问说明。所以，也可以简单地表述为：“这是访问 planslurpen.no 网站的 Swagger API 文档界面的链接”
• 网站https://planslurpen.no/（这个网址本身在中文中没有直接的翻译，但可以表述为“访问planslurpen.no网站”）

字符限制

服务器对响应内容实施了25,000个字符的限制。如果响应内容被截断：

• 使用 planslurpen_get_plan_fields 查看可用过滤器的工具
• 使用（以下方法）应用滤镜 felt_kode 或者 klassifikasjoner 参数
• 请求特定字段，而非完整输出

错误处理

服务器提供了清晰、可操作的错误信息：

• 404 页面未找到计划不存在 - 请验证市镇编号和计划ID
• 400 请求错误无效参数 - 请检查参数格式
• 超时响应过大 - 使用过滤器减小大小
• 网络错误连接问题 - 检查网络连接

发展

这台服务器遵循了MCP的最佳实践：

• 使用 Pydantic v2 进行输入验证
• 实现带有描述性消息的适当错误处理
• 支持多种响应格式（JSON 和 Markdown）
• 包括字符限制和截断功能
• 所有工具均为只读且幂等
• 全面的文档字符串和类型提示

Beta通知

Planslurpen目前处于测试阶段。人工智能解释的质量可能有所不同，且该服务正在积极收集反馈。如果您遇到问题或对解释质量有反馈，请访问https://planslurpen.no/进行报告。

许可证

此MCP服务器按原样提供，用于与Planslurpen API一起使用。有关API使用限制，请参阅Planslurpen的服务条款。

链接

• Planslurpen 网站：https://planslurpen.no/
• MCP（模型上下文协议）文档：https://modelcontextprotocol.io/
• 示例计划：https://planslurpen.no/1106/RL791/3

支持

对于以下问题：

• 这个MCP服务器在仓库中打开一个问题（或提交一个问题）
• “Planslurpen service”可以翻译为“计划吞噬服务”或根据具体语境稍作调整，但直接翻译可能略显生硬，因为“Planslurpen”并非一个常见的英文词汇，可能是某个特定领域或创意项目中的术语。如果这是一个虚构的服务名称，且没有具体上下文，那么“计划吞噬服务”可以作为一个基本的翻译，但具体含义可能需要根据上下文进一步解释或调整。如果这是一个实际存在的服务，建议查找其官方中文名称或根据官方描述进行翻译访问 https://planslurpen.no/ 获取联系方式
• MCP协议请参阅 https://modelcontextprotocol.io/

______________________________________________________________________

为挪威规划社区倾心打造