Scorecard

Servidor MCP Scorecard no Cloudflare

Este repositório permite que você implante um servidor MCP remoto no Cloudflare Workers, permitindo que Claude e outros clientes MCP acessem as ferramentas de avaliação do Scorecard.

Comece agora:

Isso implantará seu servidor MCP Scorecard em uma URL como: scorecard-mcp.<your-account>.workers.dev/sse

Alternativamente, você pode clonar este repositório e implantá-lo usando Wrangler:

git clone https://github.com/scorecard-ai/scorecard-mcp.git
cd scorecard-mcp
npm install
npm run deploy

Sobre Este Servidor MCP

Este servidor MCP fornece acesso às ferramentas de avaliação do Scorecard diretamente do Claude e de outros clientes compatíveis com MCP. Ele usa Clerk para autenticação e é construído no Cloudflare Workers para implantação global e confiável.

O servidor implementa a especificação MCP (2025-03-26) e fornece acesso seguro à API do Scorecard para executar experimentos, gerar dados sintéticos, configurar métricas e analisar o desempenho do modelo.

Conecte-se a Clientes MCP

Este servidor MCP funciona com vários clientes compatíveis com MCP:

Conecte-se ao claude.ai, Cursor e Windsurf

Após a implantação, você pode se conectar ao seu servidor MCP a partir do Claude e de outros clientes compatíveis com MCP fornecendo a URL do seu servidor:

https://scorecard-mcp.<your-account>.workers.dev/sse

Conecte-se via Cloudflare AI Playground

Você também pode se conectar através do Cloudflare AI Playground:

1. Vá para https://playground.ai.cloudflare.com/
2. Insira a URL do seu servidor MCP implantado (scorecard-mcp.<your-account>.workers.dev/sse)
3. Agora você pode usar as ferramentas de avaliação do Scorecard diretamente do playground!

Conecte-se via Claude Desktop

Para testes locais, você pode se conectar ao seu servidor MCP a partir do Claude Desktop usando o proxy mcp-remote.

Siga o Quickstart da Anthropic e, dentro do Claude Desktop, vá para Configurações > Desenvolvedor > Editar Config.

Atualize com esta configuração:

{
  "mcpServers": {
    "scorecard": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://scorecard-mcp.<your-account>.workers.dev/sse"  // or http://localhost:8787/sse for local testing
      ]
    }
  }
}

Reinicie o Claude e você verá as ferramentas disponíveis.

Desenvolvimento Local

Para desenvolvimento local, crie um arquivo ".dev.vars" com suas credenciais do Clerk:

cp .dev.vars.example .dev.vars

Configure as seguintes variáveis no seu arquivo .dev.vars:

Variável	Fonte	Observações
CLERK_CLIENT_ID	Clerk Dashboard -> Configure -> OAuth Applications
CLERK_CLIENT_SECRET	Clerk Dashboard -> Configure -> OAuth Applications	Não pode ser visualizado após a geração inicial
CLERK_DOMAIN	Clerk Dashboard -> Configure -> API Keys -> Frontend API URL	Substitua pela URL de desenvolvimento do Clerk se estiver usando com o servidor Scorecard local
CLERK_PUBLISHABLE_KEY	Clerk Dashboard -> Configure -> API Keys -> Publishable Key	Substitua pela chave pk_test_* se estiver usando com o servidor Scorecard local

Em seguida, execute o servidor de desenvolvimento:

npm install
npm run dev

Lembre-se de executar npx wrangler types para gerar tipos para as variáveis de ambiente.

Colaboradores

Agradecimento especial a Dustin Moore pela liderança em engenharia no desenvolvimento desta implementação MCP.