Skip to main content

​
Prerequisites

  • Python 3.10 or later
  • pip (Python package manager)
  • A Semust API key from Settings > API Key

​
Install Dependencies

Clone or download the MCP server files, then install the required packages:
The dependencies are:
  • mcp>=1.0.0 — Model Context Protocol framework
  • requests>=2.32.0 — HTTP client
  • python-dotenv>=1.0.0 — Environment variable management

​
Verify Installation

Check that Python and the dependencies are correctly installed:

​
Environment Setup

Create a .env file in the MCP server directory:
.env
Never commit your .env file to version control. It is already included in .gitignore.

​
Test the Server

Run the server manually to verify everything works:
If the server starts without errors, you’re ready to configure your AI client.
In normal use, your AI client (Claude Desktop, Cursor, etc.) starts the server automatically. You only need to run it manually for testing.

​
Next Steps

Configuration

Learn about all configuration options and environment variables.

Setup Guides

Connect the server to Claude Desktop, Cursor, or other AI clients.