What is the MCP Civil Tools Server?

The MCP Civil Tools Server is a Python-based server compliant with the Model Context Protocol (MCP). It provides a range of civil engineering calculation tools and coordinate conversion functionalities, designed for seamless integration with LLMs and AI Agents.

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs, allowing AI models to access and interact with external data sources and tools.

What are the main features of the MCP Civil Tools Server?

The main features include:

• Coordinate conversion (Latitude/Longitude to UTM/TWD97 and vice versa).
• Civil engineering calculations (Manning’s equation, earth pressure coefficients, slope stability analysis, etc.).
• List Supported Materials API for easy access to available material options.
• Error handling and user assistance for improved usability.
• Multiple deployment options (CLI and HTTP service mode).

How do I install the MCP Civil Tools Server?

1. Create a virtual environment.
2. Install the dependencies using pip install -r requirements.txt.
3. Configure the MCP settings in mcp.json.
4. Launch the server in either CLI or HTTP service mode.

How do I configure the mcp.json file?

In the mcp.json file, specify the path to your virtual environment’s python.exe as the command and the path to the mcp_server.py file as the args.

What coordinate systems are supported?

The server supports conversion between Latitude/Longitude and UTM/TWD97 coordinate systems.

What calculations are supported?

The server supports a wide range of calculations, including:

• Manning’s equation for open channel flow.
• Active and passive earth pressure coefficients.
• Drainage ditch velocity and flow calculations.
• Slope stability analysis.
• Soil erosion modeling.
• Runoff calculation.
• Retaining wall verification.
• Vegetation recommendation.
• Material parameter lookup.
• Slope protection recommendation.
• Infiltration facility design.
• IDF curve analysis.

What is the List Supported Materials API?

This API provides a list of all supported materials for various calculation tools, such as Manning’s coefficient materials, soil types, and land uses. It helps users easily identify available options and reduces input errors.

How do I run the server in HTTP service mode?

Use the command uvicorn src/mcp_server:app --port 8000 to start the server in HTTP service mode.

How does the MCP Civil Tools Server integrate with UBOS?

UBOS allows you to seamlessly integrate the MCP Civil Tools Server into AI Agent workflows, connect it with enterprise data sources, and build custom AI Agents to automate complex tasks.

What are the default parameters for coordinate conversions?

• When only latitude and longitude are provided, the default UTM/TM2 Zone is TM2-121, and the default hemisphere is the Northern Hemisphere.
• When only planar coordinates X and Y are provided, the default UTM Zone is TWD97, and the hemisphere is the Northern Hemisphere.

What if I input an incorrect material name?

The server will return an error message and automatically suggest a list of supported materials for the specific calculation tool.

What license is the MCP Civil Tools Server released under?

The MCP Civil Tools Server is released under the MIT License, allowing for free use and contribution.