Claude Code MCP OAuth 成功后 initialize 超时深度排查指南

# Linux / macOS / WSL 终端环境变量
export NO_PROXY="localhost,127.0.0.1,::1,10.0.0.0/8,192.168.0.0/16"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,192.168.0.0/16"

# Windows PowerShell 配置
$env:NO_PROXY="localhost,127.0.0.1,::1"
$env:no_proxy="localhost,127.0.0.1,::1"

import sys
import logging

# 严禁在 MCP 服务中使用 print() 直写 stdout
# 必须统一配置 logging 输出到 stderr
logging.basicConfig(
    stream=sys.stderr,
    level=logging.INFO,
    format='%(asctime)s [%(levelname)s] %(message)s'
)
logging.info("MCP 服务后台加载完成，不会污染 JSON-RPC 通信流")

import subprocess
import json
import sys

def probe_mcp_server(command_args):
    print(f"[探针] 正在拉起子进程: {' '.join(command_args)}")
    proc = subprocess.Popen(
        command_args,
        stdin=subprocess.PIPE,
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        text=True,
        bufsize=1
    )

    init_payload = {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "initialize",
        "params": {
            "protocolVersion": "2024-11-05",
            "capabilities": {},
            "clientInfo": {"name": "DiagnosticProbe", "version": "1.0.0"}
        }
    }

    try:
        print("[探针] 正在向 stdin 写入 initialize 握手帧...")
        proc.stdin.write(json.dumps(init_payload) + "\n")
        proc.stdin.flush()

        # 等待首行响应
        raw_response = proc.stdout.readline()
        if not raw_response:
            stderr_out = proc.stderr.read()
            print("[错误] 未收到标准输出，服务端提前退出！stderr 错误信息:")
            print(stderr_out)
            return False

        print(f"[收到原始响应]: {raw_response.strip()}")
        data = json.loads(raw_response)
        if "result" in data and "capabilities" in data["result"]:
            print("[成功] MCP initialize 协议握手通过！工具能力正常上报。")
            return True
        else:
            print("[警告] 收到响应但非合法 capabilities 结构:", data)
            return False
    except json.JSONDecodeError:
        print("[严重] 握手失败：stdout 返回了非法 JSON 数据（说明有脏日志污染了输出流）！")
        return False
    except Exception as e:
        print(f"[异常] 探针执行错误: {e}")
        return False
    finally:
        proc.terminate()

if __name__ == "__main__":
    # 传入你的 MCP 启动参数进行诊断，例如: python mcp_handshake_probe.py python ./server.py
    if len(sys.argv) < 2:
        print("用法: python mcp_handshake_probe.py <命令> [参数...]")
    else:
        probe_mcp_server(sys.argv[1:])

# 设置中转网关端点与固定凭证
export ANTHROPIC_BASE_URL="https://api.gpt345.com/v1"
export ANTHROPIC_API_KEY="sk-gpt345-your-enterprise-key"

# 禁用脆弱的第三方 OAuth 重试，强制启用稳定调用
export CLAUDE_CODE_FORCE_DIRECT="1"
export MCP_TIMEOUT="30000"

# 启动 Claude Code，直连全功能模型
claude