MCP Civil Tools

This project is a Python server based on the MCP protocol, providing functions for querying and calculating soil and water conservation technical specifications, including engineering calculations such as Manning's coefficient, earth pressure coefficient, drainage ditch flow velocity, and slope stability, as well as the conversion between latitude and longitude and UTM/TWD97 coordinates in Taiwan region. It is suitable for AI application integration.

Education and learning tools Law and compliance #Civil engineering #Soil and water conservation #Coordinate conversion #AI tool .Python

rating : 2.5 points

downloads : 8.4K

update time : 2025-04-28

Open Site

What is MCP Civil Tools?

This is a professional civil engineering calculation server that transforms the Taiwan Soil and Water Conservation Technical Specifications (2023 Edition) into an intelligent tool that can be queried through natural language. It supports more than 20 professional calculation functions such as Manning's coefficient query, earth pressure calculation, drainage ditch design, and slope stability analysis.

How to use it?

Ask questions directly in natural language through a client that supports the MCP protocol (such as Claude Desktop), or call the calculation functions through the HTTP API. Professional calculation results can be obtained without programming.

Applicable scenarios

In the field of civil engineering such as soil and water conservation design, drainage system planning, retaining wall inspection, and slope stability evaluation, it is especially suitable for scenarios that require quick query of specification parameters or verification of design schemes.

Main functions

Coordinate conversion

Bidirectional conversion between latitude and longitude and UTM/TWD97 coordinates in Taiwan region, supporting custom projection parameters

Hydraulic calculation

Calculate the flow velocity and flow depth of drainage sections, supporting 7 types of cross - sections such as rectangular, trapezoidal, and circular, and automatically checking the water depth and flow velocity specifications

Slope stability analysis

Calculate the safety factor and evaluate the stability, considering factors such as slope, soil parameters, and groundwater level

Retaining wall inspection

Check the sliding/tilting safety factors of gravity retaining walls, supporting normal and seismic conditions

Soil erosion calculation

Calculate the soil loss using the USLE formula, with a built - in database of rainfall erosion index R values for the whole of Taiwan

Advantages

Natural language interaction, no need to memorize complex instructions

Instantly return the specification compliance check results

The calculation process is transparent, providing complete formulas and basis articles

Support batch calculation and report generation

Limitations

The calculation results need to be reviewed by professionals

Currently only applicable to Taiwan region specifications

Some complex working conditions require manual input of parameters

How to use

Installation preparation

Ensure that Python 3.8+ is installed. It is recommended to use a virtual environment.

Install dependencies

Install the necessary Python packages.

Start the service

Select the startup mode: - CLI mode for direct interaction - HTTP service for API calls

Usage examples

Drainage ditch design verification

Verify whether the concrete drainage ditch design meets the specification requirements

Retaining wall stability analysis

Evaluate the safety of the retaining wall under earthquake conditions

Frequently Asked Questions

How to query the available material list?

What should I do if there is a difference between the calculation result and the manual calculation?

Does it support custom material parameters?

Related resources

Soil and Water Conservation Technical Specifications

The latest version of Taiwan Soil and Water Conservation Technical Specifications

GitHub Repository

Project source code and issue tracking

MCP Protocol Description

Official documentation of the Model Context Protocol

🚀 MCP Channel Flow Calculation Report - 50-Year Design Flow

This report focuses on the flow calculation of the MCP channel under a 50-year design scenario, providing detailed design conditions, channel parameters, hydraulic calculations, and corresponding conclusions and suggestions.

🚀 Quick Start

This report presents the calculation and analysis of the MCP channel's 50-year design flow. It includes design conditions, channel parameters, hydraulic calculations, and conclusions with suggestions.

✨ Features

Precise calculation of design flow based on specific rainfall intensity and duration.
Comprehensive check of channel's water - passing capacity, flow velocity, and freeboard.
Practical suggestions for improving channel design safety and resilience.

📦 Installation

N/A

💻 Usage Examples

N/A

📚 Documentation

🔍 Design Conditions

Rainfall Intensity (I): Based on the 50 - year, 60 - minute rainfall intensity - duration curve in New Taipei City, the value is 140.0 mm/hr.
Rainfall Duration (D): 60 minutes.
Design Flow (Q): The calculation result is 1.03 cms.

📏 Channel Design Parameters

Channel Cross - Section Type: Rectangular.
Channel Material: Concrete.
Manning's Roughness Coefficient (n): 0.012.
Channel Width (b): 50 cm.
Channel Depth (H): 60 cm.
Channel Slope (S): 2.5% (0.025 m/m).

💧 Hydraulic Calculation and Verification

Water - Passing Capacity Check

Design Flow: Q_design = 1.03 cms.
Actual Flow Velocity (V): The calculation result is 4.014 m/s.
Actual Water Depth (y): The calculation result is 51.3 cm.

Flow Velocity Check

Allowable Flow Velocity Range for Concrete: 4.57 ~ 6.1 m/s (refer to common values in soil and water conservation technical specifications).
Assessment: The calculated flow velocity of 4.014 m/s is less than the lower limit of the allowable flow velocity for concrete (4.57 m/s), indicating that this flow velocity is safe for the concrete channel itself and will not cause channel scouring.

Freeboard Check

Calculated Freeboard: H - y = 60.0 cm - 51.3 cm = 8.7 cm.
Assessment: Under the design flow, the freeboard is slightly insufficient. It is recommended to consider increasing the channel depth to increase the safety factor.

📋 Conclusions and Suggestions

Water - Passing Capacity: The designed concrete channel section (width 50 cm, depth 60 cm) can accommodate a design flow of 1.03 cms.
Flow Velocity: The calculated flow velocity of 4.014 m/s is within the safe allowable range for concrete.
Freeboard: The calculated freeboard is 8.7 cm, which is relatively low.
Suggestion: Although this section can theoretically pass the design flow, considering the possibility of actual construction errors, sediment deposition, or future flow increase, it is recommended to appropriately increase the channel depth (e.g., to 70 cm or more) to provide a more sufficient freeboard and increase the overall safety and resilience of the design.