MCP服务器二进制文件

Oktopus MCP Server的预构建二进制文件,提供多平台支持并可通过环境变量配置运行参数。

  • by OktopUSP
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 OktopUSP/mcp-server-public

使用说明

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

可用版本

看 发布 对于所有可用版本。