mcpField
V
volcengine-vefaas

volcengine-vefaas

github.com/volcengineCloud & DevOps24100 installsUpdated 4d ago
Repository

About volcengine-vefaas

volcengine-vefaas is a CLI skill for deploying and managing serverless applications on Volcengine Function Service. It covers authentication, project initialization, deployment, function code retrieval, and configuration.

Key features

  1. 01Initialize projects from templates
  2. 02Deploy new or existing applications
  3. 03Manage functions and retrieve code
  4. 04Configure environment variables
  5. 05Check authentication and view domains

Use cases

  1. 01Deploy a serverless application from a template
  2. 02Publish an existing project through CI/CD
  3. 03Pull function code for local work
  4. 04Set environment variables and inspect configuration

MCP support

The documentation includes guidance for MCP deployment, including protocol, run.sh, proxy, and path-selection checks. It does not describe MCP tools or resources exposed by the project.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/volcengine/volcengine-skills --skill volcengine-vefaas

After installing, type/volcengine-vefaasin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
authentication.md
configuration.md
environment-variables.md
framework-detection.md
mcp-deployment.md
troubleshooting.md
references/cookbooks/
deploy-existing-code.md
manage-functions.md
template-quickstart.md

Details

From the project README

volcengine-vefaas: Volcengine FaaS CLI

vefaas is the command-line tool for Volcengine Function Service (veFaaS). It enables serverless application deployment, function management, and configuration through a streamlined workflow.

Installation

npm i -g https://vefaas-cli.tos-cn-beijing.volces.com/volcengine-vefaas-latest.tgz

Verify installation:

vefaas --version

Core Workflow

The typical deployment pattern:

  1. Check Node.js: node --version (requires >= 18, recommended 20+)
    • If version is too low, switch using nvm (nvm use 20) or fnm (fnm use 20), or manually install a newer version
  2. Check CLI: vefaas --version to verify installation
  3. Check Auth: vefaas login --check to verify login status
    • If not logged in, run vefaas login --sso (opens browser, auto-completes when user authorizes - no manual input needed)
  4. Deploy: vefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes
  5. Access: vefaas domains to view URLs

Quick Commands

PurposeCommand
Check authvefaas login --check
Login (SSO)vefaas login --sso (non-interactive: opens browser, auto-completes when authorized, recommended)
Login (AK/SK)vefaas login --accessKey <AK> --secretKey <SK>
Init from templatevefaas init --template <name>
Deploy new appvefaas deploy --newApp <name> --gatewayName $(vefaas run listgateways --first) --yes
Deploy existingvefaas deploy --app <name> --yes
List gatewaysvefaas run listgateways --first
View URLsvefaas domains
Set env varvefaas env set KEY VALUE
View configvefaas config list
Pull codevefaas pull --func <name>
Inspect projectvefaas inspect

Global Options

OptionDescription
-d, --debugEnable debug mode for troubleshooting
--yesNon-interactive mode (required for CI/AI coding)
--regionRegion override (e.g., cn-beijing)

Cookbooks

Step-by-step guides for common scenarios:

References

Detailed documentation on specific topics:

Important Notes

  • Always use --yes for non-interactive mode in CI/CD and AI coding scenarios
  • Use $(vefaas run listgateways --first) to get an available gateway
  • Config is stored in .vefaas/config.json after linking
  • Use --debug or -d to troubleshoot issues

Comments

Markdown supported