Geztio Platform

Geztio MCP 服务（co.geztio/platform）

适用于 Geztio 的官方 Model Context Protocol（MCP）服务——现代化的建筑项目管理与工程经济平台。

将 AI 助手（Claude Desktop、Cursor、Claude Code、Windsurf、Antigravity、自定义 Agent）直接连接到 Geztio 的单价分析（APU / Análisis de Precios Unitarios）、CBS 预算树、动态价目表、资源目录和项目运营。

---

🏗️ 概述

Geztio 为建筑公司、项目经理、成本工程师和现场团队提供项目经济数据的唯一可信来源。通过此 MCP 服务，AI 模型可以：

• 搜索和分析 APU（UnitCost）：查询构成明细、产量、单位成本，以及材料、设备、人工和运输的嵌套配方。
• 查询资源目录（Resource）：搜索材料、设备、人工和运输投入，并查看动态解析的单位价格。
• 浏览 CBS 和预算方案（BudgetTree）：遍历项目章节和预算项，检查数量、地点和分项合计。
• 审计和比较价目表（PriceList）：发现异常定价、核验区域价目表，并模拟方案变化。
• 执行异步操作：批量导入资源并跟踪执行任务状态。

---

⚡ 快速开始与配置

1. Claude Desktop

在 claude_desktop_config.json 中将 Geztio 添加为远程 MCP 服务：

{
  "mcpServers": {
    "geztio": {
      "url": "https://mcp.geztio.co/mcp"
    }
  }
}

首次连接时，Claude Desktop 将自动发起 OAuth 2.0 握手，以验证你的 Geztio 组织和成员账户。

2. Cursor IDE

在 Cursor 设置 → 功能 → MCP 中：

1. 点击 + 添加新的 MCP 服务。
2. 名称：geztio
3. 类型：Streamable HTTP
4. URL：https://mcp.geztio.co/mcp

3. Antigravity 和 Agent 框架

要使用官方 @modelcontextprotocol/sdk 或 Python SDK 从自定义 Agent 连接：

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.geztio.co/mcp") as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        print([t.name for t in tools])

---

🛡️ 安全与多租户

• 组织范围限制：每项查询都严格限定在经过身份验证的成员所属组织内。
• 席位等级成本屏蔽：
  • SeatTier.FULL：办公室用户和项目经理可以查看所有直接成本、货币和分项合计。
  • SeatTier.FIELD：现场主管和现场执行成员可以查看项目数量、配方和范围；成本字段会安全地屏蔽为 null。
• 细粒度权限范围：
  • geztio:read：只读访问目录、预算、项目和价目表。
  • unit_costs:write：创建或更新 APU 单位成本和项目配方。
  • resources:write：创建或更新目录资源。
  • budgets:write：创建预算章节并更新预算项数量。
  • projects:write：创建新项目。
  • operations:write：将批量导入和批处理作业加入队列。

---

🛠️ 工具目录

身份与上下文

工具	权限范围	描述
geztio_whoami	geztio:read	识别经过身份验证的成员、组织、席位等级（sees_money）和当前订阅方案。

单位成本分析（APU / UPA）

工具	范围	描述
geztio_search_unit_costs	geztio:read	按名称或代码搜索 APU，可选择按嵌套类型和项目筛选。
geztio_get_unit_cost_detail	geztio:read	详细展示 APU 的分项资源、产量、损耗系数，以及根据指定 PriceList 解析出的成本。
geztio_create_unit_cost	unit_costs:write	在组织或项目目录中创建新的单位成本配方。
geztio_add_unit_cost_item	unit_costs:write	向 APU 配方中添加资源项（材料、人工、设备、运输）。
geztio_remove_unit_cost_item	unit_costs:write	从 APU 配方中移除一项。

资源（投入）与价格表

工具	范围	描述
geztio_search_resources	geztio:read	搜索资源（材料、人工、设备、运输），并显示解析后的单价。
geztio_create_resource	resources:write	注册新的资源，并指定单位和定价模式。
geztio_list_price_lists	geztio:read	列出启用的价格表（区域、标准、项目专属）。

项目、预算与 CBS 章节

工具	范围	描述
geztio_search_projects	geztio:read	按名称、代码和执行状态搜索项目。
geztio_get_project_overview	geztio:read	项目的完整概览，包括其有效合同预算和情景版本。
geztio_create_project	projects:write	在组织中创建新项目。
geztio_get_budget_tree	geztio:read	完整的工作分解结构（WBS/CBS）章节树，包含数量和行合计。
geztio_create_chapter	budgets:write	在预算版本的 CBS 层级结构中创建新的章节节点。
geztio_update_budget_item_quantity	budgets:write	更新预算版本中的行项目数量。

操作与批处理

工具	范围	描述
geztio_import_resources	operations:write	异步批量导入或更新资源目录。返回一个 execution_id。
geztio_get_execution_status	geztio:read	查询异步执行的进度、错误和令牌／配额使用情况。

---

💬 提示词

服务包含预置的 MCP 提示词模板：

1. analizar_unit_cost：对 APU 进行技术分析（组成、产量、价格一致性和优化建议）。
2. comparar_unit_costs：比较两个相似的 APU（差异项、成本差异和建议用途）。
3. auditar_lista_de_precios：自动审计价格表，标记统计异常值、缺失价格或可疑差异。

---

📦 资源

提供稳定且可通过 URI 寻址的引用：

• geztio://project/{ref}：项目的直接 JSON 表示。
• geztio://unit-cost/{ref}：APU 配方的直接 JSON 表示。

---

🚀 发布与注册表维护

此存储库使用 mcp-publisher 将元数据发布到 Official MCP Registry。

域名认证（geztio.co）

命名空间 co.geztio/* 的域名所有权通过 DNS TXT 记录进行验证：

geztio.co. IN TXT "v=MCPv1; k=ed25519; p=<PUBLIC_KEY_BASE64>"

手动发布

# 1. Login with domain private key
mcp-publisher login dns --domain "geztio.co" --private-key "$MCP_REGISTRY_PRIVATE_KEY"

# 2. Publish server.json
mcp-publisher publish

---

📄 许可证

此存储库采用 MIT License 许可。