Squad MCP-Server

Ein Model Context Protocol (MCP)-Server verbindet Squad – die KI-gestützte Plattform für Produktfindung und -strategie – mit jeder MCP-fähigen Large Language Model (LLM)-Anwendung. Er bietet ein umfangreiches Toolkit zum Erstellen, Abfragen und Aktualisieren von Produktstrategie-Artefakten (Chancen, Lösungen, Ergebnisse, Anforderungen, Wissen, Arbeitsbereiche und Feedback) direkt von Ihrem bevorzugten KI-Copiloten aus.

Dieses Repository enthält auch den Quellcode für das NPM-Paket @squadai/tools , das die clientseitigen Tools für die Interaktion mit der Squad-API bereitstellt.

Warum?

Mit dem Squad MCP-Server können Sie in einem Gesprächsfluss Produkte recherchieren, Ideen entwickeln und planen, ohne jemals Ihren Editor oder Ihr Chatfenster zu verlassen.

Related MCP server: TianGong-AI-MCP

✨ Werkzeuge

Jedes Tool entspricht dem MCP-JSON-Schemaformat, sodass Agenten Ein- und Ausgaben automatisch prüfen können.

🚀 Schnellstart

1 · Erhalten Sie einen Squad-API-Schlüssel

1. Registrieren/Anmelden unter https://meetsquad.ai .

2. Öffnen Sie Einstellungen → Entwickler → API-Schlüssel .

3. Erstellen Sie einen Schlüssel und kopieren Sie den Wert.

2 · Führen Sie den Server aus

Wählen Sie die Installationsmethode, die am besten zu Ihrer Umgebung passt.

Option A – Eigenständige ausführbare Datei (empfohlen für die lokale Verwendung)

Laden Sie die neueste Binärdatei für Ihr Betriebssystem von der GitHub-Releases -Seite des Projekts herunter und führen Sie sie direkt aus:

# Windows
squad-mcp.exe

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

Übergeben Sie Umgebungsvariablen auf die übliche Weise:

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

Option B – Docker (für die Produktion empfohlen)

# 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

Option C – Aus der Quelle

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

📦 NPM-Paket (@squadai/tools)

Dieses Repository enthält auch ein NPM-Paket, @squadai/tools , das eine Reihe von Funktionen für die programmgesteuerte Interaktion mit der Squad-API aus Ihren eigenen Node.js-Anwendungen oder -Skripten bereitstellt.

So installieren Sie das Paket:

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

Anschließend können Sie die Tools in Ihren Code importieren und verwenden. Zur Authentifizierung benötigen Sie weiterhin einen Squad-API-Schlüssel oder JWT (siehe Abschnitt „Schnellstart“ oben).

Anwendungsbeispiel (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?',
});

⚙️ Integration mit einem MCP-Client

Fügen Sie der Konfiguration Ihres Clients einen mcpServers- Eintrag hinzu (z. B. claude_desktop_config.json oder Cursor ). Passen Sie den Befehl an die Installationsmethode an.

Verwenden der eigenständigen ausführbaren Datei

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

Verwenden von 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",
      }
    }
  }
}

Bevorzugen Sie "command": "npx" , wenn Sie über NPX installiert haben.

Sobald Ihr Client neu gestartet ist, sollten die Squad-Tools (Hammer-Symbol 🔨) aufgelistet und einsatzbereit sein.

🛠️ Umgebungsvariablen

🧑‍💻 Entwicklung

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

Die Testsuite ist in Arbeit; Beiträge sind willkommen.