Cursor Admin

Servidor MCP Cursor Admin

🚀 Instalação Rápida

npx -y cursor-admin-mcp

É isso. Seu assistente de IA acabou de evoluir.

🎯 O Que Você Obtém

Pense nisso como equipar sua IA com visão de raio-X para sua equipe de desenvolvimento:

• 🏢 Lista da Equipe - Saiba instantaneamente quem está na equipe e suas funções
• 📊 Análises de Uso - Veja quem está realmente codando vs. quem está em reuniões
• 💰 Rastreador de Créditos - Saiba exatamente para onde estão indo seus créditos de IA
• 📈 Métricas de Produtividade - Linhas adicionadas, taxas de aceitação de IA, modelos favoritos
• 🔍 Insights Profundos - Qual desenvolvedor usa quais ferramentas, quando estão mais ativos

💪 Por Que Isso Importa

Pare de pedir atualizações de status para sua equipe. Sua IA agora pode te dizer:

• "Quem escreveu mais código esta semana?"
• "Qual é a nossa tendência de gastos com IA?"
• "Qual membro da equipe tem a maior taxa de aceitação de IA?"
• "Mostre padrões de uso do último mês"

📸 Veja em Ação

You: "Show me team usage for this week"

AI: Here's your team's activity for the last 7 days:

👥 TEAM MEMBERS
1. James Brady (Owner) - james@jamesbrady.org
2. Cody Vincent - vincent.cody298@gmail.com
3. 2 other members

📊 USAGE STATISTICS
• Most Active: Cody Vincent (641 AI requests)
• Most Productive: Cody Vincent (29,477 lines added)
• Top Models: claude-4-opus, gpt-4, claude-sonnet
• Active Days: 2/4 members coding daily

💰 SPENDING: $1,957.32 total
• James Brady: $1,848.57 (94.4%)
• Cody Vincent: $73.76 (3.8%)
• Others: $34.99 (1.8%)

Instalação

Pré-requisitos

• Node.js 16+
• Uma chave de API de administrador da equipe Cursor (obtenha nas configurações da sua equipe)

Instalar via npm

npm install -g cursor-admin-mcp

Instalar a partir do código-fonte

git clone https://github.com/h3ro-dev/cursor-admin-mcp.git
cd cursor-admin-mcp
npm install
npm run build

Configuração

1. Configure sua chave de API

Crie um arquivo .env na raiz do projeto (ou defina a variável de ambiente):

CURSOR_API_KEY=key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Configure no Claude Desktop

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cursor-admin": {
      "command": "npx",
      "args": ["cursor-admin-mcp"],
      "env": {
        "CURSOR_API_KEY": "key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Configure no Cursor

Adicione às configurações do seu Cursor:

{
  "mcpServers": {
    "cursor-admin": {
      "command": "node",
      "args": ["/path/to/cursor-admin-mcp/dist/index.js"],
      "env": {
        "CURSOR_API_KEY": "key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Ferramentas Disponíveis

1. get_team_members

Obtenha uma lista de todos os membros da equipe com suas informações.

Exemplo de uso no Claude/Cursor:

"Show me all team members"
"List everyone on the team with their roles"

Retorna:

[
  {
    "name": "John Doe",
    "email": "john@example.com",
    "role": "admin"
  },
  {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "role": "member"
  }
]

2. get_daily_usage_data

Recupere métricas detalhadas de uso para um intervalo de datas especificado (máximo de 90 dias).

Parâmetros:

• startDate: Data de início em milissegundos de época
• endDate: Data de término em milissegundos de época

Exemplo de uso no Claude/Cursor:

"Show me usage data for the last 7 days"
"What was our team's AI acceptance rate last month?"
"Which models did we use most this week?"

Retorna:

[
  {
    "date": "2024-01-15",
    "linesAdded": 1523,
    "linesDeleted": 342,
    "acceptanceRate": 0.82,
    "requestTypes": {
      "completion": 234,
      "chat": 56,
      "edit": 23
    },
    "mostUsedModels": ["gpt-4", "claude-3"],
    "mostUsedExtensions": ["copilot", "cursor-tab"],
    "clientVersion": "0.42.0"
  }
]

3. get_spending_data

Obtenha informações de gastos da equipe com filtragem e paginação opcionais.

Parâmetros Opcionais:

• searchTerm: Filtrar por termo de busca
• sortBy: Campo para ordenar
• sortDirection: "asc" ou "desc"
• page: Número da página
• pageSize: Itens por página

Exemplo de uso no Claude/Cursor:

"Show me team spending"
"Who are the top spenders this month?"
"Search for John's spending data"

Retorna:

{
  "members": [
    {
      "email": "john@example.com",
      "name": "John Doe",
      "spending": 125.50
    }
  ],
  "total": 1250.00,
  "page": 1,
  "pageSize": 10
}

Desenvolvimento

Configuração

# Clone the repository
git clone https://github.com/h3ro-dev/cursor-admin-mcp.git
cd cursor-admin-mcp

# Install dependencies
npm install

# Copy environment file
cp .env.example .env
# Edit .env and add your CURSOR_API_KEY

# Run in development mode
npm run dev

Testes

# Run tests
npm test

# Run tests with coverage
npm test -- --coverage

# Run tests in watch mode
npm run test:watch

Compilação

# Build the project
npm run build

# Run the built version
npm start

Estrutura do Projeto

cursor-admin-mcp/
├── src/
│   ├── index.ts          # MCP server implementation
│   └── cursor-client.ts  # Cursor API client
├── tests/
│   └── cursor-client.test.ts  # Test suite
├── examples/
│   └── (example scripts)
├── docs/
│   └── (additional documentation)
├── package.json
├── tsconfig.json
├── jest.config.js
├── .env.example
├── .gitignore
└── README.md

Exemplos

Uso Básico

// The MCP server handles all the communication
// Just use natural language in Claude/Cursor:

"Show me all team members and their roles"
"Get usage data for January 2024"
"What's our team's total spending this month?"
"Show me the AI acceptance rate trend for the last 30 days"

Consultas Avançadas

// Complex date ranges
"Compare usage between last week and this week"

// Specific metrics
"Which team members have the highest AI suggestion acceptance rate?"

// Spending analysis
"Show me spending sorted by amount for team members whose name contains 'John'"

Tratamento de Erros

O servidor inclui tratamento abrangente de erros:

• Chave de API Inválida: Mensagem de erro clara se a autenticação falhar
• Limitação de Taxa: Respeita os limites de taxa da API do Cursor
• Validação de Datas: Garante que os intervalos de datas não excedam 90 dias
• Erros de Rede: Tratamento gracioso de problemas de conexão
• Parâmetros Inválidos: Mensagens de validação detalhadas

Segurança

• Chaves de API nunca são registradas ou expostas
• Toda comunicação usa HTTPS
• Autenticação básica conforme requisitos da API do Cursor
• Variáveis de ambiente para dados sensíveis

Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do repositório
2. Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
4. Envie para o branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Diretrizes de Desenvolvimento

• Escreva testes para novos recursos
• Atualize a documentação
• Siga as melhores práticas de TypeScript
• Garanta que todos os testes passem
• Adicione exemplos para novas funcionalidades

Solução de Problemas

Problemas com Chave de API

Se você receber erros de autenticação:

1. Verifique se sua chave de API começa com key_
2. Garanta que você é um administrador da equipe
3. Verifique se a chave não foi revogada

Problemas de Conexão

Se o servidor não conectar:

1. Verifique sua conexão com a internet
2. Verifique se a API do Cursor está acessível
3. Verifique se há restrições de firewall

Erros de Intervalo de Datas

Se você receber erros de intervalo de datas:

1. Garanta que seu intervalo de datas esteja dentro de 90 dias
2. Use milissegundos de época para datas
3. Verifique se endDate > startDate

Licença

Licença MIT - veja o arquivo LICENSE para detalhes

Agradecimentos

• Construído para o editor Cursor
• Implementa o Model Context Protocol
• Usa o MCP SDK oficial

Suporte

• 🐛 Reportar bugs
• 💡 Solicitar recursos
• 📖 Ler a documentação
• 💬 Participar de discussões

---