世界量子大脑mcp
设置
- 安装依赖项：
python 配置前运行我_安装必要依赖包.py- 配置环境变量（推荐）：
- 复制
.env.example到.env并设定你的价值观。服务器将自动加载这些。 - 必修的：
- CREDENTIALS_EMAIL, CREDENTIALS_PASSWORD
- 可选：
- API_SETTINGS_TIMEOUT （秒，默认值30） - FORUM_SETTINGS_BASE_URL （默认值https://support.worldquantbrain.com) - FORUM_SETTINGS_HEADLESS （真/假，默认为真） - FORUM_SETTINGS_TIMEOUT （秒，默认值15） - FORUM_MAX_CONCURRENCY （默认值1；序列化论坛操作以减少会话争用） - FORUM_RATE_LIMIT_SECONDS （默认值为0；禁用额外的MCP侧论坛冷却，例如设置。 10 如果你想在论坛电话之间有一个软间隙） - MCP_HOST （远程HTTP的默认值为0.0.0.0） - MCP_PORT （默认值为8000） - MCP_STREAMABLE_HTTP_PATH （默认值/mcp）
服务器仍然支持 user_config.json但是 .env 值优先于重叠的键。
- 如下所述运行MCP服务器。
运行（流式HTTP）
从激活虚拟环境的项目根目录开始：
./.venv/bin/mcp run --transport streamable-http main.py:mcpStreamable HTTP端点将侦听 http://$MCP_HOST:$MCP_PORT$MCP_STREAMABLE_HTTP_PATH （默认值：0.0.0.0:8000/mcp）。使用HTTPS反向代理进行生产。
详细安装（推荐）
- 创建并激活Python虚拟环境（如果你还没有）：
python3 -m venv .venv
source .venv/bin/activate- 使用提供的安装程序脚本升级pip并安装项目依赖项：
pip install -U pip
python 配置前运行我_安装必要依赖包.py- （可选，但论坛/剧作家工具需要）安装剧作家和浏览器引擎：
pip install playwright
python -m playwright install chromiumPlaywright系统包（Linux）
如果你打算在Linux主机上使用论坛/剧作家工具，playwright的Chromium需要几个操作系统库。在Ubuntu/Debian系统上，在运行之前安装运行时依赖项 python -m playwright install chromium:
sudo apt-get update
sudo apt-get install -y --no-install-recommends \
libnspr4 libnss3 libgbm1 libgtk-3-0 libx11-xcb1 libxss1 \
libatk1.0-0 libatk-bridge2.0-0 libpango-1.0-0 libxrandr2 \
libxcomposite1 libxdamage1 libxkbcommon0 libcups2 ca-certificates \
fonts-liberation xz-utils unzip wget
# On some Ubuntu releases the ALSA package is provided under a different name
# (e.g. `libasound2t64`). If `libasound2` has no candidate, install the
# distribution-provided package that provides `libasound.so.2`.
sudo apt-get install -y libasound2 || sudo apt-get install -y libasound2t64 || true安装操作系统包后，运行Playwright安装并验证Chromium可以启动：
pip install -U playwright
python -m playwright install chromium
# Quick verification (headless):
./.venv/bin/python - <<'PY'
from playwright.sync_api import sync_playwright
with sync_playwright() as pw:
browser = pw.chromium.launch()
page = browser.new_page()
page.goto('https://example.com')
print(page.title())
browser.close()
PY- 启动流式HTTP MCP服务器：
./.venv/bin/mcp run --transport streamable-http main.py:mcp笔记：
- 如果您的环境限制安装系统软件包，请让管理员预安装
python3-venv和python3-pip. - 对于生产环境，将nginx/caddy（HTTPS）放置在MCP Streamable HTTP端点之前，并在下运行MCP进程
systemd为了可靠性。
Nginx反向代理示例
将示例配置放置在 /etc/nginx/sites-available/mcp_http 符号链接到 sites-enabled. 此仓库中的示例文件： deploy/nginx/mcp_http.conf.
要点：
- 使用
proxy_http_version 1.1和proxy_set_header Connection ""以允许长期流连接。 - 禁用缓冲
proxy_buffering off因此响应立即流动。 - 把TLS（Let's Encrypt/certbot）放在nginx前面，或者用你的证书配置nginx。
启用站点后重新加载nginx：
sudo ln -s /etc/nginx/sites-available/mcp_http /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxsystemd服务示例
单位文件包含在 deploy/systemd/mcp-sse.service --复制到 /etc/systemd/system/ 并启用：
sudo cp deploy/systemd/mcp-sse.service /etc/systemd/system/mcp-http.service
sudo systemctl daemon-reload
sudo systemctl enable --now mcp-http.service
sudo journalctl -u mcp-http -f该装置使用 /opt/project/world-quant-brain-mcp/.env 作为 EnvironmentFile 并运行 mcp 来自virtualenv的CLI。调整路径， User，以及适合您环境的权限。