Сервер MCP отряда

Сервер Model Context Protocol (MCP) , который соединяет Squad — платформу для разработки и разработки стратегии на основе ИИ — с любым приложением LLM с поддержкой MCP. Он предоставляет богатый набор инструментов для создания, запроса и обновления артефактов стратегии продукта (возможностей, решений, результатов, требований, знаний, рабочих пространств и обратной связи) напрямую от вашего любимого второго пилота ИИ.

Этот репозиторий также содержит исходный код для пакета NPM @squadai/tools , который предоставляет клиентские инструменты для взаимодействия с API Squad.

Почему?

С помощью сервера Squad MCP вы можете исследовать, разрабатывать идеи и планировать продукты в едином диалоговом потоке, не покидая редактора или окна чата.

Related MCP server: TianGong-AI-MCP

✨ Инструменты

Каждый инструмент соответствует формату схемы MCP JSON, поэтому агенты могут автоматически анализировать входные и выходные данные.

🚀 Быстрый старт

1 · Получите ключ API Squad

1. Зарегистрируйтесь/войдите на сайт https://meetsquad.ai .

2. Откройте Настройки → Разработчик → Ключи API .

3. Создайте ключ и скопируйте значение.

2 · Запустить сервер

Выберите тот метод установки, который подходит для вашей среды.

Вариант A — Автономный исполняемый файл (рекомендуется для локального использования)

Загрузите последнюю версию двоичного файла для вашей операционной системы со страницы релизов проекта на GitHub и запустите ее напрямую:

# Windows
squad-mcp.exe

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

Передайте переменные окружения обычным способом:

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

Вариант B – Docker (рекомендуется для производства)

# 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

Вариант C – Из источника

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 (@squadai/tools)

Этот репозиторий также включает пакет NPM @squadai/tools , который предоставляет набор функций для программного взаимодействия с API Squad из ваших собственных приложений или скриптов Node.js.

Для установки пакета:

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

Затем вы можете импортировать и использовать инструменты в своем коде. Вам по-прежнему понадобится ключ API Squad или JWT для аутентификации (см. раздел «Быстрый старт» выше).

Пример использования (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?',
});

⚙️ Интеграция с клиентом MCP

Добавьте запись mcpServers в конфигурацию вашего клиента (например, claude_desktop_config.json или Cursor ). Отрегулируйте команду в соответствии с методом установки.

Использование автономного исполняемого файла

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

Использование Докера

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

Если вы устанавливаете через NPX, предпочтительнее использовать "command": "npx" .

После перезапуска клиента вы увидите список инструментов Squad (значок молотка 🔨), готовых к использованию.

🛠️ Переменные среды

🧑‍💻 Разработка

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

Тестовый набор находится в стадии разработки; любые предложения приветствуются.