스쿼드 AI

스쿼드 MCP 서버

AI 기반 제품 탐색 및 전략 플랫폼인 Squad를 MCP 지원 대용량 언어 모델(LLM) 애플리케이션에 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다 . 선호하는 AI 코파일럿에서 제품 전략 아티팩트(기회, 솔루션, 결과, 요구 사항, 지식, 작업 공간 및 피드백)를 직접 생성, 쿼리 및 업데이트할 수 있는 풍부한 툴킷을 제공합니다.

이 저장소에는 Squad API와 상호 작용하기 위한 클라이언트 측 도구를 제공하는 @squadai/tools NPM 패키지의 소스 코드도 포함되어 있습니다.

왜?

Squad MCP 서버를 사용하면 편집기나 채팅 창을 벗어나지 않고도 대화 흐름 속에서 제품을 조사하고, 아이디어를 내고, 계획할 수 있습니다.

✨ 도구

도구 접두사	목적	일반적인 동작
기회_*	제품 기회를 발견하고 개선하세요	생성, 나열, 업데이트
해결책_*	솔루션 생성 및 반복	생성, 나열, 업데이트
결과_*	원하는 비즈니스 또는 사용자 결과 추적	만들다, 나열하다
요구 사항_*	자세한 요구 사항 파악	만들다, 나열하다
지식_*	유용한 참고자료/연구자료를 저장하세요	만들다, 나열하다
작업공간_*	Squad 작업 공간 관리	얻다, 업데이트하다
피드백_*	고객 또는 분석 피드백을 Squad로 보내세요	만들다

각 도구는 MCP JSON 스키마 형식을 따르므로 에이전트는 입력과 출력을 자동으로 검토할 수 있습니다.

🚀 빠른 시작

1 · Squad API 키 얻기

https://meetsquad.ai 에서 가입/로그인하세요.
설정 → 개발자 → API 키를 엽니다.
키를 생성하고 값을 복사합니다.

2 · 서버 실행

귀하의 환경에 맞는 설치 방법을 선택하세요.

옵션 A – 독립 실행형 실행 파일 (로컬 사용에 권장)

프로젝트의 GitHub 릴리스 페이지에서 운영 체제에 맞는 최신 바이너리를 다운로드하여 직접 실행하세요.

지엑스피1

일반적인 방법으로 환경 변수를 전달합니다.

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 도 포함되어 있습니다. 이 패키지는 Node.js 애플리케이션이나 스크립트에서 Squad API와 프로그래밍 방식으로 상호 작용할 수 있는 함수 세트를 제공합니다.

패키지를 설치하려면:

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

그런 다음 코드에서 도구를 가져와 사용할 수 있습니다. 인증을 위해서는 Squad API 키 또는 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 도구(망치 🔨 아이콘)가 나열되어 사용할 준비가 된 것을 볼 수 있습니다.

🛠️ 환경 변수

변하기 쉬운	필수의	기본	설명
`SQUAD_API_KEY`	예	–	Squad에서 생성된 개인 액세스 토큰
`SQUAD_ENV`	아니요	`production`	Squad API 기본 URL( `staging` , `development` 등)을 재정의합니다.

🧑‍💻 개발

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

테스트 모음은 진행 중입니다. 기여를 환영합니다.

Squad AI

스쿼드 MCP 서버

왜?

✨ 도구

🚀 빠른 시작

1 · Squad API 키 얻기

2 · 서버 실행

옵션 A – 독립 실행형 실행 파일 (로컬 사용에 권장)

옵션 B – Docker (프로덕션에 권장)

옵션 C – 소스에서

📦 NPM 패키지 (@squadai/tools)

⚙️ MCP 클라이언트와 통합

독립 실행형 실행 파일 사용

도커 사용하기

🛠️ 환경 변수

🧑‍💻 개발

Related MCP Servers

tavily-search

Algoliaofficial

Trivyofficial

Agent Interviews

New MCP Servers

MCP directory API