MCP 指南deprecated

MCP 历史架构概述（未公开）

保留的 MCP 架构概念说明，不代表 RailWise 已对外发布可调用的 MCP 服务。

复核 2026-07-20入门不进入公开索引RailWise 技术团队

MCP 指南

RailWise MCP Server 概述

1. 什么是 MCP

模型上下文协议（Model Context Protocol，MCP） 是由 Anthropic 发起的一个开放标准协议，旨在为 AI 模型与外部工具、数据源之间建立标准化的通信接口。MCP 允许 AI 助手（如 Claude、Cursor、Windsurf 等）通过统一的协议访问外部系统的功能和数据，实现真正的工具调用能力。

RailWise MCP Server 是宁波睿威工程技术有限公司基于 MCP 协议标准开发的官方服务端实现，为工程测量与安全监测领域的 AI 应用提供标准化的工具接入能力。

2. RailWise MCP Server 简介

RailWise MCP Server 是一套面向工程测量与安全监测行业的 MCP 协议服务端实现，它将 RailWise 核心产品的能力封装为 MCP 工具和资源，使 AI 助手能够：

查询监测数据：实时获取全站仪自动化监测数据、沉降数据、位移数据等
管理监测项目：创建、配置和管理监测项目与测点信息
执行计算分析：调用工程测量计算工具（坐标转换、平差计算、变形分析等）
访问知识资源：检索技术规范、标准文档、历史案例等结构化知识
控制监测设备：通过 AI 助手发起全站仪测量指令、配置监测参数

2.1 核心特性

特性	描述
标准化协议	完整实现 MCP 协议规范，兼容所有支持 MCP 的 AI 平台
多产品集成	统一封装 RAILWISE-TSM、RAILWISE-OS、RAILWISE-CLI 的核心能力
实时数据访问	支持实时查询监测数据、设备状态、项目信息
安全认证	基于 API Key 的认证机制，支持细粒度权限控制
类型安全	所有工具参数和返回值均使用 JSON Schema 严格定义
本地/云端部署	支持本地私有部署和 RailWise 云服务两种模式

2.2 技术架构

┌─────────────────────────────────────────────────────────┐
│                    AI 助手客户端                           │
│         (Claude / Cursor / Windsurf / 其他)               │
└──────────────────────┬──────────────────────────────────┘
                       │ MCP 协议 (stdio / SSE)
┌──────────────────────▼──────────────────────────────────┐
│              RailWise MCP Server                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │
│  │  Tools 层   │  │ Resources 层│  │ Prompts 层  │   │
│  │  (工具调用)  │  │ (资源访问)  │  │ (提示模板)  │   │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘   │
│         └─────────────────┼──────────────────┘          │
│                         │                              │
│  ┌──────────────────────▼──────────────────────┐       │
│  │         RailWise 产品服务层                  │       │
│  │  ┌────────┐ ┌────────┐ ┌────────┐ ┌──────┐│       │
│  │  │TSM API │ │OS API  │ │CLI API │ │KB API││       │
│  │  └────────┘ └────────┘ └────────┘ └──────┘│       │
│  └────────────────────────────────────────────┘       │
└─────────────────────────────────────────────────────────┘

3. 适用场景

3.1 智能监测数据分析

通过 MCP Server，AI 助手可以直接访问 RAILWISE-TSM 的实时监测数据，帮助工程师：

快速查询特定时间段内的监测数据趋势
识别异常数据点并生成预警分析
对比历史数据，评估结构安全状态
自动生成监测日报/周报的数据摘要

3.2 自动化测量工作流

结合 RAILWISE-CLI 的多智能体能力，AI 助手可以：

执行标准化的测量任务序列
调用坐标转换、平差计算等工程计算工具
生成测量报告草稿，供工程师审核

3.3 知识库智能检索

访问 RailWise 知识库资源，AI 助手能够：

检索技术规范和标准文档
查询历史项目案例和解决方案
获取设备操作手册和配置指南

3.4 监测项目管理

通过集成 RAILWISE-OS 的业务能力，实现：

查询项目基本信息、测点配置、监测方案
获取设备列表和运行状态
查看人员排班和任务分配

4. 支持的 AI 平台

RailWise MCP Server 已通过以下 AI 平台的兼容性测试：

AI 平台	支持版本	传输方式	状态
Claude Desktop	0.8.0+	stdio	✅ 已验证
Cursor	0.45.0+	stdio	✅ 已验证
Windsurf	1.0.0+	stdio	✅ 已验证
Cline	3.0.0+	stdio	✅ 已验证
Continue	0.8.0+	stdio	✅ 已验证
自定义客户端	-	stdio / SSE	✅ 协议兼容

注意：不同 AI 平台对 MCP 功能的支持程度可能有所差异。Claude Desktop 和 Cursor 对工具调用（Tool Use）的支持最为完善，建议优先使用。

5. 快速开始

5.1 安装 MCP Server

# 使用 npm 全局安装
npm install -g @railwise/mcp-server

# 或使用 npx 直接运行
npx @railwise/mcp-server

5.2 配置 AI 客户端

以 Claude Desktop 为例，在配置文件中添加：

{
  "mcpServers": {
    "railwise": {
      "command": "npx",
      "args": ["-y", "@railwise/mcp-server"],
      "env": {
        "RAILWISE_API_KEY": "your-api-key-here",
        "RAILWISE_API_URL": "https://api.railwise.cn/v1"
      }
    }
  }
}

详细配置说明请参考 MCP Server 安装配置。

5.3 开始使用

配置完成后，在 AI 助手的对话中即可使用 RailWise 工具：

用户：查询一下宁波地铁3号线最近24小时的沉降监测数据。

AI：我将为您查询宁波地铁3号线最近24小时的沉降监测数据。

[AI 调用 railwise_query_monitoring_data 工具]

AI：根据查询结果，宁波地铁3号线最近24小时共采集了 1,248 个测点的数据：

正常测点：1,240 个（99.4%）

黄色预警：6 个（0.5%）

橙色预警：2 个（0.1%）

最大沉降量出现在 K3+520 断面，累计沉降 -12.3mm，变化速率 -0.8mm/天，建议关注该断面附近施工活动。

6. 版本信息

版本	发布日期	主要更新	兼容性
1.0.0	2025-01-15	初始版本，支持基础工具集	MCP 协议 2024-11-05
1.1.0	2025-02-20	新增资源访问能力、Prompt 模板	MCP 协议 2024-11-05
1.2.0	2025-04-10	新增批量数据查询、设备控制工具	MCP 协议 2025-03-26

7. 相关文档

MCP Server 安装配置 — 详细的安装步骤和环境配置
MCP Server 工具列表 — 完整的工具清单和参数说明
MCP Server 资源访问 — 可访问的资源类型和路径格式
MCP Server 集成示例 — 与主流 AI 平台的集成教程
MCP Server 安全与认证 — 认证方式、权限控制和数据安全
MCP Server 故障排查 — 常见问题排查和解决方案

8. 获取支持

技术支持邮箱：support@railwise.cn
开发者社区：https://dev.railwise.cn
GitHub Issues：https://github.com/railwise/mcp-server/issues
企业微信：扫描官网二维码加入开发者群

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