Servidor MCP del escuadrón

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta Squad , la plataforma de descubrimiento y estrategia de productos basada en IA, con cualquier aplicación de modelo de lenguaje grande (LLM) compatible con MCP. Ofrece un completo conjunto de herramientas para crear, consultar y actualizar artefactos de estrategia de producto (oportunidades, soluciones, resultados, requisitos, conocimiento, espacios de trabajo y retroalimentación) directamente desde su copiloto de IA favorito.

Este repositorio también contiene el código fuente del paquete NPM @squadai/tools , que proporciona las herramientas del lado del cliente para interactuar con la API de Squad.

¿Por qué?

Con Squad MCP Server puedes investigar, idear y planificar productos en un flujo conversacional, sin tener que abandonar el editor o la ventana de chat.

Related MCP server: Algolia

✨ Herramientas

Cada herramienta se ajusta al formato de esquema JSON de MCP para que los agentes puedan introspeccionar las entradas y salidas automáticamente.

🚀 Inicio rápido

1 · Obtener una clave API de Squad

1. Regístrate / inicia sesión en https://meetsquad.ai .

2. Abra Configuración → Desarrollador → Claves API .

3. Crea una clave y copia el valor.

2 · Ejecutar el servidor

Elija el método de instalación que mejor se adapte a su entorno.

Opción A: Ejecutable independiente (recomendado para uso local)

Descargue el binario más reciente para su sistema operativo desde la página de lanzamientos de GitHub del proyecto y ejecútelo directamente:

# Windows
squad-mcp.exe

# macOS / Linux — make the file executable first
chmod +x squad-mcp
./squad-mcp

Pase las variables de entorno de la forma habitual:

SQUAD_API_KEY=<your‑key> SQUAD_ENV=production ./squad-mcp

Opción B – Docker (recomendado para producción)

# Build the image (once)
docker build -t mcp/meet-squad -f Dockerfile .

# Run the server on stdio
docker run --rm -i \
  -e SQUAD_API_KEY=<your‑key> \
  mcp/meet-squad

Opción C – Desde la fuente

git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
npm install
npm run build           # transpiles to ./dist
node dist/index.js

📦 Paquete NPM (@squadai/tools)

Este repositorio también incluye un paquete NPM, @squadai/tools , que proporciona un conjunto de funciones para interactuar con la API de Squad mediante programación desde sus propias aplicaciones o scripts Node.js.

Para instalar el paquete:

npm install @squadai/tools
# or
yarn add @squadai/tools
# or
pnpm add @squadai/tools

Luego, puedes importar y usar las herramientas en tu código. Necesitarás una clave API de Squad o JWT para la autenticación (consulta la sección de inicio rápido más arriba).

Ejemplo de uso (Vercel AI):

import { generateText, tool } from 'ai';
import { tools as squadTools } from "@squadai/tools"

const result = await generateText({
  model: yourModel,
  tools: squadTools({
    jwt: "JWT",
    orgId: "orgId",
    workspaceId: "workspaceId"
  }),
  prompt: 'What is the weather in San Francisco?',
});

⚙️ Integración con un cliente MCP

Agregue una entrada "mcpServers" a la configuración de su cliente (p. ej., claude_desktop_config.json o Cursor ). Ajuste el comando para que coincida con el método de instalación.

Usando el ejecutable independiente

{
  "mcpServers": {
    "meet-squad": {
      "command": "C:/path/to/squad-mcp.exe",
      "env": {
        "SQUAD_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

Usando Docker

{
  "mcpServers": {
    "meet-squad": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "SQUAD_API_KEY",
        "mcp/meet-squad"
      ],
      "env": {
        "SQUAD_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

Prefiera "command": "npx" si lo instaló mediante NPX.

Una vez que su cliente se reinicie, debería ver las herramientas de Squad (ícono de martillo 🔨) enumeradas y listas para usar.

🛠️ Variables de entorno

🧑‍💻 Desarrollo

npm install
npm run format      
npm run openapi:squad   # re‑generate typed client from openapi/squad.json
npm run build       
node dist/index.js

El conjunto de pruebas está en proceso de desarrollo, se agradecen contribuciones.