MCP 历史资源设计（未公开）

历史设计资料，当前未公开

RailWise 当前没有对外发布 MCP Server、安装包、API Key 或配置端点。以下内容仅保留为历史架构草案，其中的命令、环境变量、地址与版本号都不能作为实际部署依据。请改用 AI Agent 使用公开知识的规则。

RailWise MCP Server 资源访问

1. 资源访问概述

MCP 协议除了支持工具调用（Tools）外，还定义了资源访问（Resources）机制。与工具调用不同，资源访问是只读的，用于让 AI 助手获取结构化的参考信息，如文档、配置、模板等。

RailWise MCP Server 提供以下资源类型：

资源类型	说明	访问权限
技术规范	工程测量与安全监测相关的国家标准、行业规范	读取
项目文档	监测项目的技术方案、设计文档	按项目权限
设备手册	全站仪等监测设备的操作手册和配置指南	读取
知识库文章	RailWise 知识库中的技术文章和最佳实践	读取
报告模板	监测日报、周报、月报的模板文件	读取
计算公式	常用的工程测量计算公式和参数说明	读取

2. 资源 URI 格式

RailWise MCP Server 使用以下 URI 方案标识资源：

railwise://{resource_type}/{resource_id}[?{query_params}]

2.1 URI 结构说明

组件	说明	示例
scheme	固定为 railwise	railwise://
resource_type	资源类型标识	standards, projects, manuals
resource_id	资源唯一标识	GB-50026-2020, PRJ-A1B2C3D4
query_params	可选查询参数	?version=latest&format=markdown

2.2 资源类型列表

资源类型	URI 前缀	说明
standards	railwise://standards/	国家标准和行业规范
projects	railwise://projects/	项目相关文档
manuals	railwise://manuals/	设备操作手册
kb	railwise://kb/	知识库文章
templates	railwise://templates/	报告模板
formulas	railwise://formulas/	计算公式

3. 资源类型详解

3.1 技术规范（standards）

包含工程测量与安全监测领域常用的国家标准和行业规范。

URI 示例：

railwise://standards/GB-50026-2020
railwise://standards/CJJ-T-8-2011
railwise://standards/JGJ-8-2016

可用资源列表：

资源 ID	名称	类型
GB-50026-2020	工程测量标准	国家标准
GB-50497-2019	建筑基坑工程监测技术标准	国家标准
CJJ-T-8-2011	城市测量规范	行业标准
JGJ-8-2016	建筑变形测量规范	行业标准
TB-10101-2018	铁路工程测量规范	行业标准
CJJ-202-2013	城市轨道交通结构安全保护技术规范	行业标准
GB-50911-2013	城市轨道交通工程监测技术规范	国家标准

资源内容结构：

{
  "uri": "railwise://standards/GB-50026-2020",
  "mimeType": "text/markdown",
  "text": "# GB 50026-2020 工程测量标准\n\n## 1 总则...",
  "metadata": {
    "standard_code": "GB 50026-2020",
    "title": "工程测量标准",
    "publish_date": "2020-12-01",
    "effective_date": "2021-06-01",
    "issuing_authority": "住房和城乡建设部",
    "category": "国家标准",
    "version": "2020",
    "page_count": 245
  }
}

---

3.2 项目文档（projects）

与具体监测项目相关的技术文档，访问权限受项目权限控制。

URI 格式：

railwise://projects/{project_id}/{document_type}/{document_id}

document_type 类型：

类型	说明	URI 示例
scheme	监测方案	railwise://projects/PRJ-A1B2C3D4/scheme/main
report	监测报告	railwise://projects/PRJ-A1B2C3D4/report/daily/2025-01-15
config	项目配置	railwise://projects/PRJ-A1B2C3D4/config/points
log	工作日志	railwise://projects/PRJ-A1B2C3D4/log/2025-01

资源内容示例（监测方案）：

{
  "uri": "railwise://projects/PRJ-A1B2C3D4/scheme/main",
  "mimeType": "text/markdown",
  "text": "# 宁波地铁3号线控制保护区监测方案\n\n## 1 工程概况...",
  "metadata": {
    "project_id": "PRJ-A1B2C3D4",
    "project_name": "宁波地铁3号线控制保护区监测",
    "document_type": "monitoring_scheme",
    "version": "v2.1",
    "last_modified": "2024-08-15T10:30:00Z",
    "author": "张三",
    "reviewer": "李四"
  }
}

---

3.3 设备手册（manuals）

监测设备的操作手册、配置指南和故障排查文档。

URI 格式：

railwise://manuals/{device_type}/{model}/{document_type}

可用资源：

资源 URI	说明
railwise://manuals/total_station/leica_ts16/operation	徕卡 TS16 全站仪操作手册
railwise://manuals/total_station/leica_ts16/config	徕卡 TS16 配置指南
railwise://manuals/total_station/trimble_s7/operation	天宝 S7 全站仪操作手册
railwise://manuals/sensor/settlement_gauge/operation	沉降计操作手册
railwise://manuals/sensor/inclinometer/operation	测斜仪操作手册

---

3.4 知识库文章（kb）

RailWise 知识库中的技术文章、最佳实践和常见问题解答。

URI 格式：

railwise://kb/{category}/{article_id}

文章分类：

分类	说明	URI 示例
best-practices	最佳实践	railwise://kb/best-practices/tsm-automation-setup
troubleshooting	故障排查	railwise://kb/troubleshooting/data-transmission-failure
tutorial	使用教程	railwise://kb/tutorial/first-monitoring-project
faq	常见问题	railwise://kb/faq/api-rate-limit
case-study	案例研究	railwise://kb/case-study/subway-crossing-bridge

---

3.5 报告模板（templates）

监测报告的标准模板，支持 Markdown 格式。

URI 格式：

railwise://templates/{template_type}/{template_name}

可用模板：

资源 URI	说明	格式
railwise://templates/daily_report/standard	监测日报模板	Markdown
railwise://templates/weekly_report/standard	监测周报模板	Markdown
railwise://templates/monthly_report/standard	监测月报模板	Markdown
railwise://templates/alert_report/urgent	紧急预警报告模板	Markdown
railwise://templates/summary_report/final	项目总结报告模板	Markdown

---

3.6 计算公式（formulas）

工程测量中常用的计算公式和参数说明。

URI 格式：

railwise://formulas/{formula_category}/{formula_id}

可用公式资源：

资源 URI	说明
railwise://formulas/coordinate/gauss_projection	高斯投影正算/反算公式
railwise://formulas/coordinate/seven_parameter	七参数坐标转换公式
railwise://formulas/adjustment/indirect	间接平差公式
railwise://formulas/deformation/settlement_rate	沉降速率计算公式
railwise://formulas/deformation/early_warning	预警等级判定公式

资源内容示例：

{
  "uri": "railwise://formulas/deformation/settlement_rate",
  "mimeType": "text/markdown",
  "text": "# 沉降速率计算公式\n\n## 公式定义\n\n沉降速率 $v$ 的计算公式为：\n\n$$v = \\frac{S_i - S_{i-1}}{t_i - t_{i-1}}$$\n\n其中：\n- $S_i$：第 $i$ 次观测的累计沉降量（mm）\n- $S_{i-1}$：第 $i-1$ 次观测的累计沉降量（mm）\n- $t_i$：第 $i$ 次观测时间\n- $t_{i-1}$：第 $i-1$ 次观测时间\n\n## 预警标准\n\n| 预警级别 | 速率阈值（mm/天） | 处理建议 |\n|---------|------------------|---------|\n| 正常 | $|v| \\leq 2$ | 正常监测 |\n| 黄色预警 | $2 < |v| \\leq 5$ | 加密监测 |\n| 橙色预警 | $5 < |v| \\leq 10$ | 现场巡查 |\n| 红色预警 | $|v| > 10$ | 停工检查 |",
  "metadata": {
    "formula_id": "settlement_rate",
    "category": "deformation",
    "applicable_standards": ["GB-50497-2019", "JGJ-8-2016"],
    "version": "1.0"
  }
}

4. 资源访问方式

4.1 AI 助手直接访问

AI 助手在需要参考信息时，会自动通过 MCP 协议的 resources/read 请求访问资源。用户无需手动指定 URI，AI 助手会根据上下文自动推断需要的资源。

示例交互：

用户：沉降速率的预警标准是什么？

AI：让我查询相关的技术规范…

[AI 助手请求资源 railwise://formulas/deformation/settlement_rate]

AI：根据《建筑变形测量规范》（JGJ 8-2016）和 RailWise 计算公式，沉降速率预警标准如下：

预警级别	速率阈值	处理建议
正常	≤ 2 mm/天	正常监测
黄色预警	2~5 mm/天	加密监测
橙色预警	5~10 mm/天	现场巡查
红色预警	> 10 mm/天	停工检查

4.2 显式资源请求

用户也可以显式请求访问特定资源：

用户：请查看 GB 50026-2020 工程测量标准中关于控制测量的要求。

AI：我将为您查看该标准的相关内容。

[AI 助手请求资源 railwise://standards/GB-50026-2020]

AI：根据 GB 50026-2020《工程测量标准》第 3 章控制测量：…

5. 资源列表订阅

MCP 协议支持资源列表订阅（Resource List Changed Notification），当服务器端的资源发生变化时，会主动通知客户端更新资源列表。

RailWise MCP Server 支持以下动态资源列表：

资源类型	动态更新场景
projects	新增项目、项目状态变更
projects/{id}/report	新增监测报告
kb	新增知识库文章
templates	新增报告模板

6. 权限控制

资源访问遵循与工具调用相同的权限体系：

资源类型	权限要求	说明
standards	无需特殊权限	公开资源，所有用户可访问
formulas	无需特殊权限	公开资源，所有用户可访问
manuals	无需特殊权限	公开资源，所有用户可访问
kb	无需特殊权限	公开资源，所有用户可访问
projects	需要项目读取权限	只能访问有权限的项目文档
templates	需要模板读取权限	根据用户角色控制

7. 资源与工具的协作

资源访问与工具调用可以协同工作，形成完整的 AI 辅助工作流：

用户提问
    ↓
AI 助手分析需求
    ↓
┌─────────────────┐    ┌─────────────────┐
│ 需要参考信息？   │ →  │ 访问资源（只读）  │
│ 需要执行操作？   │ →  │ 调用工具（读写）  │
└─────────────────┘    └─────────────────┘
    ↓
综合资源和工具结果，生成回复

典型协作示例：

用户：帮我写一份宁波地铁3号线最近一周的监测周报。

AI 执行流程：

1. 访问模板资源：railwise://templates/weekly_report/standard
2. 调用工具查询数据：railwise_query_monitoring_data
3. 调用工具分析趋势：railwise_deformation_analysis
4. 访问规范参考：railwise://standards/GB-50497-2019
5. 综合生成周报内容

8. 相关文档

• MCP Server 概述 — 功能介绍和适用场景
• MCP Server 工具列表 — 完整的工具清单和参数说明
• MCP Server 安装配置 — 详细的安装步骤
• MCP Server 安全与认证 — 认证方式和权限控制

---

本文档由 RailWise 技术文档团队维护，最后更新于 2025-01-15。