stealthsurf-vpn/mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

3 stars 1 forks 品質 70 トレンド 10MIT

Stateless MCP proxy for the StealthSurf VPN API. Enables AI agents (Claude Desktop, Cursor, etc.) to manage VPN configs, cloud servers, and subscriptions via natural language.

概要

MCP (Model Context Protocol) server for StealthSurf VPN API. Allows AI agents (Claude Desktop, Cursor, etc.) to manage VPN configs, cloud servers, paid options, and more through natural language. Thin stateless proxy: MCP tool calls → HTTP requests to StealthSurf API. 1. Go to StealthSurf dashboard → Profile → API Keys 2. Create a new key (name it anything) 3. Copy the stlth_* key (shown only once) Reference data accessible without API calls. Workflow templates that guide AI agents through multi-step scenarios.

README

以下は原文 README の抜粋です。原文を見る。

StealthSurf MCP Server

MCP (Model Context Protocol) server for StealthSurf VPN API. Allows AI agents (Claude Desktop, Cursor, etc.) to manage VPN configs, cloud servers, paid options, and more through natural language.

Architecture

Thin stateless proxy: MCP tool calls → HTTP requests to StealthSurf API.

MCP Client (Claude Desktop / Cursor)
  │  POST / (Authorization: Bearer stlth_...)
  ▼
StealthSurf MCP Server (this service)
  │  HTTP (Authorization: Bearer stlth_...)
  ▼
StealthSurf API

Setup

# Install dependencies
yarn install

# Development
yarn dev

# Production
yarn build && yarn start

Environment Variables

Variable	Default	Description
`STEALTHSURF_API_URL`	`https://api.stealthsurf.space`	API base URL
`PORT`	`4500`	HTTP server port

MCP Client Configuration

Claude Desktop

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "stealthsurf": {
      "url": "https://mcp.stealthsurf.space",
      "headers": {
        "Authorization": "Bearer stlth_your_api_key_here"
      }
    }
  }
}

Getting an API Key

Go to StealthSurf dashboard → Profile → API Keys
Create a new key (name it anything)
Copy the stlth_* key (shown only once)

Resources (4)

Reference data accessible without API calls.

URI	Description
`stealthsurf://guide`	Full StealthSurf documentation
`stealthsurf://updates`	Latest updates and changelog
`stealthsurf://errors`	API error codes reference
`stealthsurf://protocols`	VPN protocol comparison and compatibility matrix

Prompts (11)

Workflow templates that guide AI agents through multi-step scenarios.

Prompt	Description
`setup-vpn`	Interactive VPN config creation wizard
`troubleshoot`	Step-by-step connection issue diagnostics
`optimize-for-region`	Protocol recommendations by region
`account-overview`	Full account status report
`bulk-renew`	Batch renewal of expiring configs
`setup-family`	Custom subscription for sharing
`setup-cloud-server`	Full VPS setup wizard
`switch-protocol`	Bulk protocol migration
`setup-bridge`	Dual-hop bridge creation
`device-audit`	Device security audit
`xray-config`	Custom XRay configuration guide

Available Tools (92)

VPN Configs (15)

configs_list — List VPN configurations
configs_create — Create a new VPN config
configs_renew — Renew a config subscription
configs_get_tariffs — Get available tariffs
configs_get_available_servers — Get available servers
configs_get_server_stats — Get server statistics
configs_update_settings — Update config settings
configs_update_xray_config — Update custom XRay config
configs_change_title — Change config title
configs_toggle_auto_renewal — Toggle auto-renewal

GitHub で README 全文を見る

インストール

docker run -p 3000:3000 \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "stealthsurf": {
      "url": "https://mcp.stealthsurf.space",
      "headers": {
        "Authorization": "Bearer stlth_your_api_key_here"
      }
    }
  }
}