土木工程MCP工具服务器使用说明

本项目是一个基于Model Context Protocol (MCP) 构建的Python服务器，旨在为大型语言模型（LLM）客户端（如Claude Desktop）提供专业的土木工程计算和信息查询能力。

项目简介

通过集成常见的土木工程计算方法和数据，本项目将复杂的工程问题转化为可供LLM调用的标准化工具。LLM客户端可以通过MCP协议与服务器通信，调用这些工具来辅助解决土木工程相关的查询和计算任务。

主要功能点

本服务器封装了以下主要功能的工具：

坐标转换: 实现经纬度与UTM/TWD97平面坐标之间的相互转换。
土压力计算: 计算主动土压力系数和被动土压力系数。
排水沟计算: 基于曼宁公式计算不同断面（圆、矩形、梯形）的水流速度、流深、流量，并进行流速安全检核。
边坡稳定性分析: 计算边坡的滑动安全系数。
土壤侵蚀计算: 基于USLE公式计算土壤侵蚀模数/流失量。
集水区径流量计算: 基于Rational公式计算集水区最大径流量。
挡土墙稳定性检核: 对护岸/挡土墙进行滑动、倾倒、承载力等方面的稳定性检核。
植生护坡建议: 根据坡度、土壤、气候等条件提供植生护坡工法建议。
材料参数查询: 查询常用土木工程材料的设计参数（如单位重、内摩擦角、凝聚力等）。
坡面保护工法建议: 提供不同坡度、土壤、降雨条件下的坡面保护工法建议。
渗水设施设计: 提供渗水设施的设计流量和建议尺寸。
IDF曲线查询: 查询指定地点、重现期、历时对应的降雨强度。
钢筋信息查询与计算: 提供钢筋规格查询、重量计算等功能。
逕流係數查询: 依据规范查询不同土地利用类型的逕流係數。
土石笼挡土墙稳定性分析: 进行土石笼挡土墙的主动/被动土压力及稳定性分析。
U型沟钢筋量计算: 计算U型沟所需的钢筋量。
支援清單查询: 查询工具支持的材料、地区、工法等各类清單。

安装步骤

克隆仓库:

git clone https://github.com/tutumomo/MCP-civil-tools.git
cd MCP-civil-tools

创建并激活虚拟环境:

python -m venv .venv
# Windows:
.venv\Scripts\activate
# Linux/macOS:
source .venv/bin/activate

安装依赖:

pip install -r requirements.txt

服务器配置

MCP客户端需要知道如何启动这个服务器。通常需要在MCP客户端的配置文件（例如'mcp.json'或客户端设置界面）中添加一项配置。配置内容为JSON格式，至少需要指定启动命令（'command'）和参数（'args'）。

例如，在Claude Desktop或其他支持MCP的客户端中，您可以添加类似以下的配置项：

{
  "mcpServers": {
    "MCP-civil-tools": {
      "command": "path/to/.venv/Scripts/python.exe",
      "args": [
        "path/to/MCP-civil-tools/src/mcp_server.py"
      ],
      "disabled": false, // 设置为 false 启用服务器
      "autoApprove": [] // 根据需要配置自动批准调用的工具
    }
  }
}

'"command"'：请填入您的虚拟环境中的Python解释器绝对路径。
'"args"'：请填入本项目中'src/mcp_server.py'文件的绝对路径。

请根据您的操作系统和实际安装位置修改上述路径。例如，在Windows上可能是'C:/Users/YourUser/Documents/MCP-civil-tools/.venv/Scripts/python.exe'和'C:/Users/YourUser/Documents/MCP-civil-tools/src/mcp_server.py'。

基本使用方法

服务器配置完成后，启动您的MCP客户端。客户端会自动检测并启动本MCP服务器（如果配置为自动启动）。一旦连接建立，您就可以在客户端中通过对话或特定界面调用本服务器提供的土木工程工具了。

例如，您可以在LLM对话中提出问题，客户端将识别您的问题与某个工具相关，然后调用对应的服务器工具并返回计算结果。具体如何触发工具调用取决于您的MCP客户端的实现方式。请参考客户端的使用说明。

关键词