关键词

模型评估AI 工具Cloudflare Workers安全认证LLM 集成

项目简介

Scorecard MCP 服务器是一个部署在 Cloudflare Workers 上的 MCP 服务器实现，它允许兼容 MCP 的 LLM 客户端（如 Claude）通过标准的 MCP 协议安全地访问 Scorecard 的模型评估、数据生成、指标配置等功能。该项目集成了 Clerk 进行用户认证，以确保访问的安全性。

主要功能点

  • 提供 Scorecard 工具访问: 将 Scorecard 的 API 功能封装为 MCP 工具，供 LLM 客户端直接调用。
  • 处理 MCP 请求: 接收并处理来自 MCP 客户端的 JSON-RPC 请求，例如执行工具。
  • 集成用户认证: 通过 Clerk 实现 OAuth 认证流程，确保只有授权用户才能使用服务器提供的功能。
  • 支持 SSE 协议: 提供基于 Server-Sent Events (SSE) 的传输协议，便于客户端连接和通信。
  • 会话管理: 管理与不同 MCP 客户端的会话状态。

安装步骤

该服务器主要设计用于部署到 Cloudflare Workers。你有两种部署方式：

  1. 一键部署:

    • 点击项目 README 中提供的 "Deploy to Workers" 按钮。
    • 按照 Cloudflare 的指引，选择一个 Workers 服务名称并完成部署。
    • 部署过程中或部署后，你需要根据提示或在 Worker 设置中配置 Clerk 相关的环境变量（'CLERK_CLIENT_ID', 'CLERK_CLIENT_SECRET', 'CLERK_DOMAIN', 'CLERK_PUBLISHABLE_KEY'），用于身份认证。这些信息从你的 Clerk Dashboard 获取。

  2. 手动部署:

    • 克隆项目仓库到本地：'git clone https://github.com/scorecard-ai/scorecard-mcp.git'
    • 进入项目目录：'cd scorecard-mcp'
    • 安装依赖：'npm install'
    • 安装并配置 Cloudflare Wrangler CLI。
    • 创建 '.dev.vars' 文件（可以从 '.dev.vars.example' 复制），填入你的 Clerk 认证信息。这些变量也需要在最终部署到 Cloudflare Workers 时在Worker的环境变量配置中设置。
    • 运行部署命令：'npm run deploy'

无论哪种方式，部署成功后，Cloudflare Workers 会为你提供一个服务器 URL。

服务器配置 (供 MCP 客户端使用)

MCP 服务器通常通过其网络地址供 MCP 客户端连接。部署完成后，你的 Scorecard MCP 服务器会有一个类似 'https://scorecard-mcp.<your-account>.workers.dev/sse' 的 URL（最后的 '/sse' 表示 SSE 传输协议）。

大多数 MCP 客户端（如 claude.ai、Cloudflare AI Playground）只需要你在其设置界面中输入这个服务器 URL 即可连接。

对于一些客户端（如 Claude Desktop），可能需要通过一个本地代理工具（如 'mcp-remote'）来连接远程服务器。以下是 Claude Desktop 的配置示例，你需要将占位符替换为你实际部署的服务器 URL：

{
  "mcpServers": {
    "scorecard": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "YOUR_DEPLOYED_SERVER_URL"  // 将此占位符替换为你实际部署到 Cloudflare Workers 后的服务器 URL (例如: https://scorecard-mcp.<你的账户名>.workers.dev/sse)
      ]
    }
  }
}

请查阅你的 MCP 客户端文档以了解具体的服务器配置方法，核心信息是你部署的 Scorecard MCP 服务器的 URL。

基本使用方法

连接成功后，你的 MCP 客户端将能够发现 Scorecard MCP 服务器提供的工具。你可以在与 LLM 交互时，通过相应的客户端功能（如工具调用、Function Calling）来使用 Scorecard 的评估、生成数据等功能，而无需离开 LLM 界面。具体如何调用工具取决于你的 LLM 客户端如何集成 MCP 功能。

信息

分类

AI与计算

访问项目