使用说明
Oktopus MCP服务器-二进制
Oktopus MCP服务器的预构建二进制文件。
入门指南
按照以下步骤下载、配置和运行Oktopus MCP服务器:
第一步:下载二进制文件
为您的操作系统和体系结构选择合适的二进制文件:
Linux(x86_64)
curl -L -o oktopus-mcp-server https://github.com/OktopUSP/mcp-server-public/releases/latest/download/oktopus-mcp-server-linux-amd64
chmod +x oktopus-mcp-server
Linux(ARM64)
curl -L -o oktopus-mcp-server https://github.com/OktopUSP/mcp-server-public/releases/latest/download/oktopus-mcp-server-linux-arm64
chmod +x oktopus-mcp-server
macOS(英特尔)
curl -L -o oktopus-mcp-server https://github.com/OktopUSP/mcp-server-public/releases/latest/download/oktopus-mcp-server-darwin-amd64
chmod +x oktopus-mcp-server
macOS(苹果硅)
curl -L -o oktopus-mcp-server https://github.com/OktopUSP/mcp-server-public/releases/latest/download/oktopus-mcp-server-darwin-arm64
chmod +x oktopus-mcp-server
Windows(PowerShell)
Invoke-WebRequest -Uri "https://github.com/OktopUSP/mcp-server-public/releases/latest/download/oktopus-mcp-server-windows-amd64.exe" -OutFile "oktopus-mcp-server.exe"
步骤2:验证二进制文件(可选但推荐)
要验证下载的二进制文件的完整性:
# Download checksums
curl -L -o SHA256SUMS https://github.com/OktopUSP/mcp-server-public/releases/latest/download/SHA256SUMS
# Verify (macOS/Linux)
sha256sum -c SHA256SUMS
# Verify (Windows PowerShell)
Get-FileHash oktopus-mcp-server-windows-amd64.exe
步骤3:配置环境变量
在运行二进制文件之前,您必须设置所需的环境变量:
必需变量
API_BASE_URL:Oktopus控制器API的基本URL(例如。,http://localhost:8000)MCP_AUTH_TOKEN:来自Oktopus控制器登录的身份验证令牌
运输配置
MCP_TRANSPORT:通信协议-stdio或http(默认值:stdio)
HTTP传输变量(当 MCP_TRANSPORT=http)
MCP_HTTP_ADDR:HTTP服务器监听地址(例如。,:8090)MCP_ENDPOINT_PATH:MCP端点路径(例如。,/mcp)MCP_PUBLIC_BASE_URL:服务的公共HTTPS URL(例如。,https://mcp.example.com) - 生产所需
可选变量
MCP_ALLOWED_ORIGINS:逗号分隔的允许CORS源列表MCP_OAUTH_SCOPES:OAuth作用域(默认值:mcp:access)MCP_OAUTH_AUTHORIZATION_CODE_TTL:授权码TTL(默认值:5m)MCP_OAUTH_SESSION_TTL:会话TTL(默认值:30m)
步骤4:运行二进制文件
为您的操作系统选择适当的说明:
Linux/macOS(标准IO传输)
export API_BASE_URL=http://localhost:8000
export MCP_AUTH_TOKEN=your_token_here
export MCP_TRANSPORT=stdio
./oktopus-mcp-server
Linux/macOS(HTTP传输)
export API_BASE_URL=http://localhost:8000
export MCP_AUTH_TOKEN=your_token_here
export MCP_TRANSPORT=http
export MCP_HTTP_ADDR=:8090
export MCP_ENDPOINT_PATH=/mcp
export MCP_PUBLIC_BASE_URL=https://mcp.example.com
./oktopus-mcp-server
Windows(PowerShell-stdio传输)
$env:API_BASE_URL = "http://localhost:8000"
$env:MCP_AUTH_TOKEN = "your_token_here"
$env:MCP_TRANSPORT = "stdio"
.\oktopus-mcp-server.exe
Windows(PowerShell-HTTP传输)
$env:API_BASE_URL = "http://localhost:8000"
$env:MCP_AUTH_TOKEN = "your_token_here"
$env:MCP_TRANSPORT = "http"
$env:MCP_HTTP_ADDR = ":8090"
$env:MCP_ENDPOINT_PATH = "/mcp"
$env:MCP_PUBLIC_BASE_URL = "https://mcp.example.com"
.\oktopus-mcp-server.exe
可用版本
看 发布 对于所有可用版本。