mcp

Timeweb MCP Server automates deployment of applications to Timeweb Cloud using the Model Context Protocol. It exposes a set of built-in tools (prompts and commands) to create applications, integrate Git providers, and retrieve deployment presets and settings, enabling you to provision and configure Timeweb Cloud environments directly from your MCP workflow. You can run the prompts to guide the server through creating a new app, adding VCS providers, and obtaining deployment parameters, or simply issue a natural-language instruction like "Запусти мое приложение в таймвеб" and the server will detect the application type, framework, and create it automatically.

Available tools include:

• create_timeweb_app: Create a Timeweb Cloud application with automatic parameter detection.
• add_vcs_provider: Add a VCS provider for connecting Git repositories.
• get_vcs_providers: List all VCS providers.
• get_vcs_provider_repositories: List repositories for a provider.
• get_vcs_provider_by_repository_url: Find a provider by repository URL.
• get_allowed_presets: Retrieve available presets for new applications.
• get_deploy_settings: Get default deployment settings for various frameworks.

Prompts such as create_app_prompt and add_vcs_provider_prompt help guide the process by asking for necessary details and configuring the app accordingly. To use the server, you can run these prompts or give a high-level instruction like "Запусти мое приложение в таймвеб". The server will automatically determine the project type, framework, and create or configure the application in Timeweb Cloud.

Prerequisites:

• Node.js and npm installed on your machine (recommended: LTS version).
• Internet access to install packages via npx.

Installation steps:

1. Ensure Node.js is installed. You can verify with: node -v npm -v

2. Run the MCP server using npx (no local installation required): npx timeweb-mcp-server

3. (Optional) If you prefer to install locally, clone the repository and run: npm install npm start

4. Set up the required environment variable. The server expects TIMEWEB_TOKEN to authenticate with Timeweb Cloud. Example in config: { "mcpServers": { "timeweb-mcp-server": { "command": "npx", "args": ["timeweb-mcp-server"], "env": { "TIMEWEB_TOKEN": "your-api-token" } } } }

Notes and tips:

• TIMEWEB_TOKEN is required for authenticating with Timeweb Cloud. Keep it secret and do not commit to version control.
• The MCP server is marked experimental; expect possible instability and incomplete features.
• After creating an application, you may need to manually configure environment variables in the Timeweb Cloud management panel, as the chatbot does not have access to your project’s .env file.
• If you encounter issues, check that your environment variables are correctly exposed to the MCP runtime and that the Timeweb API token has appropriate permissions.