스쿼드 MCP 서버
AI 기반 제품 탐색 및 전략 플랫폼인 Squad를 MCP 지원 대용량 언어 모델(LLM) 애플리케이션에 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다 . 선호하는 AI 코파일럿에서 제품 전략 아티팩트(기회, 솔루션, 결과, 요구 사항, 지식, 작업 공간 및 피드백)를 직접 생성, 쿼리 및 업데이트할 수 있는 풍부한 툴킷을 제공합니다.
이 저장소에는 Squad API와 상호 작용하기 위한 클라이언트 측 도구를 제공하는 @squadai/tools NPM 패키지의 소스 코드도 포함되어 있습니다.
왜?
Squad MCP 서버를 사용하면 편집기나 채팅 창을 벗어나지 않고도 대화 흐름 속에서 제품을 조사하고, 아이디어를 내고, 계획할 수 있습니다.
Related MCP server: Algolia
✨ 도구
도구 접두사 | 목적 | 일반적인 동작 |
기회_* | 제품 기회를 발견하고 개선하세요 | 생성, 나열, 업데이트 |
해결책_* | 솔루션 생성 및 반복 | 생성, 나열, 업데이트 |
결과_* | 원하는 비즈니스 또는 사용자 결과 추적 | 만들다, 나열하다 |
요구 사항_* | 자세한 요구 사항 파악 | 만들다, 나열하다 |
지식_* | 유용한 참고자료/연구자료를 저장하세요 | 만들다, 나열하다 |
작업공간_* | 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에서 생성된 개인 액세스 토큰 |
| 아니요 |
| Squad API 기본 URL( |
🧑💻 개발
npm install
npm run format
npm run openapi:squad # re‑generate typed client from openapi/squad.json
npm run build
node dist/index.js테스트 모음은 진행 중입니다. 기여를 환영합니다.